# jack-liu0227/qitu-zhixue architecture

> Architecture diagram of the GitHub repository jack-liu0227/qitu-zhixue, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jack-liu0227/qitu-zhixue
- Repository: https://github.com/jack-liu0227/qitu-zhixue

## Overview

启途智学是面向学生、家长、教师和管理员的学习平台，采用 NestJS 模块化单体、PostgreSQL 与 Redis/Worker。学生主流程覆盖今日任务、项目学习与工作台、AI辅导及成长记录；家长查看进展并反馈，教师处理学生与问题，管理员治理平台及模型。图中的前端到 API 连接仅在源码索引或摘录能证实时绘出；其他功能依 README 和文件树标示，未据此推断调用关系。

Main entry points: [`packages/database/src/client.ts`](https://github.com/jack-liu0227/qitu-zhixue/blob/main/packages/database/src/client.ts) (PostgreSQL), [`services/api/src/modules/parent/parent.controller.ts`](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/parent/parent.controller.ts) (家长 API), [`apps/student-center/features/growth`](https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/growth) (成长轨迹), [`services/api/src/modules/identity-auth/auth.service.ts`](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/identity-auth/auth.service.ts) (身份认证)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["学生学习"]
  node_today["今日学习"]
  node_inspiration["灵感空间"]
  node_projects["项目学习"]
  node_workbench["制作工作台"]
  node_tutor["AI搭档<br/>[useTutorSession.ts]"]
  node_growth["成长轨迹"]
end

subgraph group_family_teacher["家庭与教师"]
  node_parent["家长端<br/>[page.tsx]"]
  node_feedback["家长反馈<br/>[feedbackService.ts]"]
  node_teacher["教师工作区<br/>[teacherApi.ts]"]
end

subgraph group_governance["平台治理"]
  node_admin["管理控制台<br/>[page.tsx]"]
  node_model_settings["模型治理<br/>[page.tsx]"]
end

subgraph group_api_domain["API领域服务"]
  node_auth["身份认证<br/>[auth.service.ts]"]
  node_request_auth["请求鉴权<br/>[request-auth.ts]"]
  node_admin_api["管理 API"]
  node_parent_api["家长 API"]
  node_directory["用户关系目录"]
  node_model_api["模型注册 API"]
  node_team_api["Agent团队运行 API"]
end

subgraph group_runtime["运行与数据"]
  node_database[("PostgreSQL<br/>[client.ts]")]
  node_learning_storage["学习计划存储"]
  node_team_worker["团队运行 Worker"]
  node_graphiti["Graphiti投影<br/>[bridge.py]"]
  node_memory["Agent记忆<br/>[index.ts]"]
end

node_learner(("学生"))

node_learner -->|"查看任务"| node_today
node_learner -->|"探索灵感"| node_inspiration
node_learner -->|"学习项目"| node_projects
node_learner -->|"制作作品"| node_workbench
node_learner -->|"AI辅导"| node_tutor
node_learner -->|"查看成长"| node_growth
node_tutor -->|"读取项目状态"| node_projects
node_parent -->|"呈现进展"| node_growth
node_parent -.->|"提交反馈"| node_feedback
node_admin -->|"管理关系"| node_directory
node_model_settings -.->|"治理模型"| node_model_api
node_request_auth -->|"校验会话"| node_auth
node_admin_api -->|"校验管理员"| node_auth
node_admin_api -->|"查询目录"| node_directory
node_parent_api -->|"校验家长"| node_auth
node_parent_api -->|"读取身份关系"| node_directory
node_parent_api -->|"读取成长摘要"| node_growth
node_learning_storage -->|"选择持久存储"| node_database
node_team_api -.->|"派发任务"| node_team_worker
node_team_worker -->|"读取与写入"| node_database
node_graphiti -.->|"投影掌握度"| node_database
node_memory -.->|"长期记忆集成"| node_database

click node_today "https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/today"
click node_inspiration "https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/inspiration"
click node_projects "https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/projects"
click node_workbench "https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/workbench"
click node_tutor "https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/student-center/features/tutor/hooks/useTutorSession.ts"
click node_growth "https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/growth"
click node_parent "https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/parent-companion/app/(protected)/progress/page.tsx"
click node_feedback "https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/parent-companion/features/feedback/feedbackService.ts"
click node_teacher "https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/teacher-workspace/lib/teacherApi.ts"
click node_admin "https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/admin-console/app/(console)/relationships/page.tsx"
click node_model_settings "https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/admin-console/app/(console)/settings/model-providers/page.tsx"
click node_auth "https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/identity-auth/auth.service.ts"
click node_request_auth "https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/common/access/request-auth.ts"
click node_admin_api "https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/admin/admin.controller.ts"
click node_parent_api "https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/parent/parent.controller.ts"
click node_directory "https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/directory/directory.service.ts"
click node_model_api "https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/model-registry/model-registry.controller.ts"
click node_team_api "https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/team-runtime/team-runtime.controller.ts"
click node_database "https://github.com/jack-liu0227/qitu-zhixue/blob/main/packages/database/src/client.ts"
click node_learning_storage "https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/learning-plan/learning-plan-storage.module.ts"
click node_team_worker "https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/workers/src/team-runtime-worker.ts"
click node_graphiti "https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/graphiti/bridge.py"
click node_memory "https://github.com/jack-liu0227/qitu-zhixue/blob/main/packages/agent-memory/src/index.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_today,node_inspiration,node_projects,node_workbench,node_tutor,node_growth toneBlue
class node_parent,node_feedback,node_teacher toneAmber
class node_admin,node_model_settings toneMint
class node_auth,node_request_auth,node_admin_api,node_parent_api,node_directory,node_model_api,node_team_api toneRose
class node_database,node_learning_storage,node_team_worker,node_graphiti,node_memory,node_learner toneIndigo
```

## Components

### 学生学习

- [今日学习](https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/today): `apps/student-center/features/today`
- [灵感空间](https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/inspiration): `apps/student-center/features/inspiration`
- [项目学习](https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/projects): `apps/student-center/features/projects`
- [制作工作台](https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/workbench): `apps/student-center/features/workbench`
- [AI搭档](https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/student-center/features/tutor/hooks/useTutorSession.ts): `apps/student-center/features/tutor/hooks/useTutorSession.ts`
- [成长轨迹](https://github.com/jack-liu0227/qitu-zhixue/tree/main/apps/student-center/features/growth): `apps/student-center/features/growth`

### 家庭与教师

- [家长端](https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/parent-companion/app/(protected)/progress/page.tsx): `apps/parent-companion/app/(protected)/progress/page.tsx`
- [家长反馈](https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/parent-companion/features/feedback/feedbackService.ts): `apps/parent-companion/features/feedback/feedbackService.ts`
- [教师工作区](https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/teacher-workspace/lib/teacherApi.ts): `apps/teacher-workspace/lib/teacherApi.ts`

### 平台治理

- [管理控制台](https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/admin-console/app/(console)/relationships/page.tsx): `apps/admin-console/app/(console)/relationships/page.tsx`
- [模型治理](https://github.com/jack-liu0227/qitu-zhixue/blob/main/apps/admin-console/app/(console)/settings/model-providers/page.tsx): `apps/admin-console/app/(console)/settings/model-providers/page.tsx`

### API领域服务

- [身份认证](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/identity-auth/auth.service.ts): `services/api/src/modules/identity-auth/auth.service.ts`
- [请求鉴权](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/common/access/request-auth.ts): `services/api/src/common/access/request-auth.ts`
- [管理 API](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/admin/admin.controller.ts): `services/api/src/modules/admin/admin.controller.ts`
- [家长 API](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/parent/parent.controller.ts): `services/api/src/modules/parent/parent.controller.ts`
- [用户关系目录](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/directory/directory.service.ts): `services/api/src/modules/directory/directory.service.ts`
- [模型注册 API](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/model-registry/model-registry.controller.ts): `services/api/src/modules/model-registry/model-registry.controller.ts`
- [Agent团队运行 API](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/team-runtime/team-runtime.controller.ts): `services/api/src/modules/team-runtime/team-runtime.controller.ts`

### 运行与数据

- [PostgreSQL](https://github.com/jack-liu0227/qitu-zhixue/blob/main/packages/database/src/client.ts): `packages/database/src/client.ts`
- [学习计划存储](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/api/src/modules/learning-plan/learning-plan-storage.module.ts): `services/api/src/modules/learning-plan/learning-plan-storage.module.ts`
- [团队运行 Worker](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/workers/src/team-runtime-worker.ts): `services/workers/src/team-runtime-worker.ts`
- [Graphiti投影](https://github.com/jack-liu0227/qitu-zhixue/blob/main/services/graphiti/bridge.py): `services/graphiti/bridge.py`
- [Agent记忆](https://github.com/jack-liu0227/qitu-zhixue/blob/main/packages/agent-memory/src/index.ts): `packages/agent-memory/src/index.ts`

### Other components

- **学生**

## Connections

- 学生 → 今日学习: 查看任务 (evidence: `README.md`)
- 学生 → 灵感空间: 探索灵感 (evidence: `README.md`)
- 学生 → 项目学习: 学习项目 (evidence: `README.md`)
- 学生 → 制作工作台: 制作作品 (evidence: `README.md`)
- 学生 → AI搭档: AI辅导 (evidence: `README.md`)
- 学生 → 成长轨迹: 查看成长 (evidence: `README.md`)
- AI搭档 → 项目学习: 读取项目状态 (evidence: `apps/student-center/features/tutor/hooks/useTutorSession.ts`)
- 家长端 → 成长轨迹: 呈现进展 (evidence: `apps/parent-companion/app/(protected)/progress/page.tsx`)
- 家长端 → 家长反馈: 提交反馈
- 管理控制台 → 用户关系目录: 管理关系 (evidence: `apps/admin-console/app/(console)/relationships/page.tsx`)
- 模型治理 → 模型注册 API: 治理模型
- 请求鉴权 → 身份认证: 校验会话 (evidence: `services/api/src/common/access/request-auth.ts`)
- 管理 API → 身份认证: 校验管理员 (evidence: `services/api/src/modules/admin/admin.controller.ts`)
- 管理 API → 用户关系目录: 查询目录 (evidence: `services/api/src/modules/admin/admin.controller.ts`)
- 家长 API → 身份认证: 校验家长 (evidence: `services/api/src/modules/parent/parent.controller.ts`)
- 家长 API → 用户关系目录: 读取身份关系 (evidence: `services/api/src/modules/parent/parent.controller.ts`)
- 家长 API → 成长轨迹: 读取成长摘要 (evidence: `services/api/src/modules/parent/parent.controller.ts`)
- 学习计划存储 → PostgreSQL: 选择持久存储 (evidence: `services/api/src/modules/learning-plan/learning-plan-storage.module.ts`)
- Agent团队运行 API → 团队运行 Worker: 派发任务
- 团队运行 Worker → PostgreSQL: 读取与写入 (evidence: `services/workers/src/team-runtime-worker.ts`)
- Graphiti投影 → PostgreSQL: 投影掌握度 (evidence: `README.md`)
- Agent记忆 → PostgreSQL: 长期记忆集成 (evidence: `README.md`)