3.0 KiB
3.0 KiB
title, type, permalink, stable_id, scope, project_id, workspace_type, usage_profile_id, preference_context, document_type, revision, source_memory_ids, source_checkpoint_ids, source_file_ids, source_git_commit, source_git_commits, source_agent_sync_ids, model_connection, model_name, source_count, source_revisions, source_dispositions, cited_source_ids, job_cited_source_ids, conflicts, supersedes, preferences, source_cursor, source_hash, prompt_version, schema_version, curation_job_id, created_at, updated_at, tags, restored_from_commit
| title | type | permalink | stable_id | scope | project_id | workspace_type | usage_profile_id | preference_context | document_type | revision | source_memory_ids | source_checkpoint_ids | source_file_ids | source_git_commit | source_git_commits | source_agent_sync_ids | model_connection | model_name | source_count | source_revisions | source_dispositions | cited_source_ids | job_cited_source_ids | conflicts | supersedes | preferences | source_cursor | source_hash | prompt_version | schema_version | curation_job_id | created_at | updated_at | tags | restored_from_commit | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Metrix System Architecture Overview | curated | main/projects/d5a7f581-c442-4554-87b9-ee723b8b0258/curated/development/metrix-system-architecture-overview | 44fc1143-7dee-4e0a-8086-42b65f39e0de | project | d5a7f581-c442-4554-87b9-ee723b8b0258 | development | null | development | architecture | 1 | e660bc7bb4fc5ccda47decb4d514874a148ed9b2 |
|
Sub2API | git-restore | 29 |
|
|
162 | e2fcea7c8a9e0df7a91925fb2a9beabd922058868310effc908f95df2d78b218 | 2026-08-12.3 | 3 | null | 2026-08-19T02:32:26.402300+00:00 | 2026-09-23T15:09:27.554762+00:00 |
|
6a6a895eaf |
Architecture Overview (2026‑08‑26)
| Layer | Component | Key Notes |
|---|---|---|
| API Gateway / FastAPI Core | git:server/app/main.py |
FastAPI app factory, OpenAPI, CORS, SPA fallback |
| Module Registry | git:server/app/modules/registry.py |
Discovers APP_MODULE objects, validates keys & deps |
| Permission Framework | git:server/app/core/permissions.py |
Action‑based RBAC; action:* → read |
| Security Utils | git:server/app/core/security.py |
PBKDF2‑SHA256 hashing, mtx_ API‑tokens, Fernet secrets |
| Database Sub‑system | ORM models, git:server/app/db/init.py, migrations |
SQLAlchemy sessions, alembic‑style registry |
| Containers Module | Docker client, WS xterm.js terminal | modules/containers/... |
| Database Module | Export/Import, APScheduler jobs, pagination | |
| Scripts Execution Platform | Preset Docker images, quota, retention policies | |
| Storage API | FTP/SFTP adapters, file‑tree service (depth/size caps) | |
| Offline Docker Deployment | scripts/build_docker.py → metrix‑app‑latest.tar (+ optional MySQL & internal PyPI) |
|
| Front‑End SPA | Vue 3 + TypeScript + Vite + Naïve‑UI; i18n (EN/ZH), dark/light themes, Monaco + Shiki, Playwright tests | |
| CI / Regression | Playwright end‑to‑end suite (tests/regression/framework.spec.ts) |
Module Interaction Flow – router guard → auth store → API client → registered pages → background job polling.
The architecture reflects the stable state captured on 2026‑08‑26 (see Current State).