MemRelay/projects/d5a7f581-c442-4554-87b9-ee723b8b0258/curated/development/Metrix System Architecture Overview.md

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	e660bc7bb4fc5ccda47decb4d514874a148ed9b2		Sub2API	git-restore	29		processed unchanged unsupported skipped 29 0 0 0	git:server/app/main.py git:server/app/modules/registry.py git:server/app/core/permissions.py git:server/app/core/security.py git:server/app/db/init.py git:server/app/migrations/registry.py					162	e2fcea7c8a9e0df7a91925fb2a9beabd922058868310effc908f95df2d78b218	2026-08-12.3	3	null	2026-08-19T02:32:26.402300+00:00	2026-09-23T15:09:27.554762+00:00	architecture fastapi vue modules	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).