chore: add c4 spec

2026-06-06 19:22:58 +08:00
commit ca9f1242f8
11 changed files with 2490 additions and 0 deletions
@@ -0,0 +1,35 @@
+# Curriculum Project Hub
+
+教研项目工作台的架构仓库。
+
+当前阶段先用 LikeC4 把产品边界、系统职责、核心领域模型和关键运行时流程敲定，再进入实现。
+
+## Architecture
+
+LikeC4 model:
+
+- [docs/architecture/likec4/specification.c4](/Users/jiarong/local/paradigm/curriculum-project-hub/docs/architecture/likec4/specification.c4)
+- [docs/architecture/likec4/model.c4](/Users/jiarong/local/paradigm/curriculum-project-hub/docs/architecture/likec4/model.c4)
+- [docs/architecture/likec4/views.c4](/Users/jiarong/local/paradigm/curriculum-project-hub/docs/architecture/likec4/views.c4)
+
+Commands:
+
+```sh
+npm install
+npm run dev
+npm run validate
+npm run build
+```
+
+Key views to review first:
+
+- `index`: system context
+- `containers`: target containers and external systems
+- `permissions`: Feishu Docs-like permission model
+- `domain_model`: Project / ProjectGroupChat / AgentSession / AgentRun / ProjectAgentLock
+- `run_lifecycle`: `@Claude` creates a run and holds a project lock
+- `context_access`: Claude reads Feishu history on demand through MCP
+
+## Decisions
+
+Architecture decisions live in [docs/architecture/adr](/Users/jiarong/local/paradigm/curriculum-project-hub/docs/architecture/adr).