Merge pull request 'wangys' (#3) from wangys into master

Reviewed-on: #3
2026-04-20 13:29:33 +08:00
parent 82d1c5c3cd 3e7ef0f891
commit 0b9c6b68d3
13 changed files with 69 additions and 78 deletions
--- a/.devcontainer/external/.env.example
+++ b/.devcontainer/external/.env.example
@@ -11,3 +11,12 @@ K12STUDY_REGISTRY_HOST=192.168.0.23
 K12STUDY_REGISTRY_PORT=8848
 K12STUDY_REGISTRY_GRPC_PORT=9848
 K12STUDY_REGISTRY_RAFT_PORT=9849
+K12STUDY_GRAPH_HOST=192.168.0.23
+K12STUDY_GRAPH_PORT=9669
+K12STUDY_GRAPH_USER=root
+K12STUDY_GRAPH_PASSWORD=nebula
+K12STUDY_VECTOR_HOST=192.168.0.23
+K12STUDY_VECTOR_PORT=19530
+K12STUDY_VECTOR_HTTP_PORT=9091
+K12STUDY_ATTU_HOST=192.168.0.23
+K12STUDY_ATTU_PORT=3000
--- a/.devcontainer/external/devcontainer.json
+++ b/.devcontainer/external/devcontainer.json
@@ -27,5 +27,9 @@
        "SPRING_PROFILES_ACTIVE": "dev",
        "K12STUDY_DEV_MODE": "external"
    },
-    "postCreateCommand": "cd /workspaces/K12study/frontend && pnpm install"
+
+    "remoteUser": "codespace",
+    "updateRemoteUserUID": true,
+
+    "postCreateCommand": "sudo chown -R codespace:codespace /pnpm-store /workspaces/K12study/frontend/node_modules"
 }
--- a/.devcontainer/external/docker-compose.yml
+++ b/.devcontainer/external/docker-compose.yml
@@ -3,9 +3,17 @@ services:
    image: mcr.microsoft.com/devcontainers/universal:2
    volumes:
      - ../../:/workspaces/K12study:cached
+      - frontend-node-modules:/workspaces/K12study/frontend/node_modules
+      - pnpm-store:/pnpm-store
    working_dir: /workspaces/K12study
    command: sleep infinity
+    user: 1000:1000  # 👈 强制权限，最关键
    environment:
+      NPM_CONFIG_USER: 1000
+      PNPM_HOME: /pnpm-store
+      PNPM_STORE_DIR: /pnpm-store
+
+      # 你原来的所有环境变量...
      K12STUDY_DB_HOST: ${K12STUDY_DB_HOST:-host.docker.internal}
      K12STUDY_DB_PORT: ${K12STUDY_DB_PORT:-5432}
      K12STUDY_DB_NAME: ${K12STUDY_DB_NAME:-k12study}
@@ -25,6 +33,12 @@ services:
      K12STUDY_VECTOR_HOST: ${K12STUDY_VECTOR_HOST:-host.docker.internal}
      K12STUDY_VECTOR_PORT: ${K12STUDY_VECTOR_PORT:-19530}
      K12STUDY_VECTOR_HTTP_PORT: ${K12STUDY_VECTOR_HTTP_PORT:-9091}
+      K12STUDY_ATTU_HOST: ${K12STUDY_ATTU_HOST:-host.docker.internal}
+      K12STUDY_ATTU_PORT: ${K12STUDY_ATTU_PORT:-3000}
      PYTHONUNBUFFERED: "1"
    extra_hosts:
      - "host.docker.internal:host-gateway"
+
+volumes:
+  frontend-node-modules:
+  pnpm-store:
--- a/.devcontainer/internal/devcontainer.json
+++ b/.devcontainer/internal/devcontainer.json
@@ -39,5 +39,5 @@
        "SPRING_PROFILES_ACTIVE": "dev",
        "K12STUDY_DEV_MODE": "internal"
    },
-    "postCreateCommand": "cd /workspaces/K12study/frontend && pnpm install"
+    "postCreateCommand": "sudo chown -R codespace:codespace /pnpm-store /workspaces/K12study/frontend/node_modules && cd /workspaces/K12study/frontend && pnpm install"
 }
--- a/.devcontainer/internal/docker-compose.yml
+++ b/.devcontainer/internal/docker-compose.yml
@@ -3,6 +3,8 @@ services:
    image: mcr.microsoft.com/devcontainers/universal:2
    volumes:
      - ../../:/workspaces/K12study:cached
+      - frontend-node-modules:/workspaces/K12study/frontend/node_modules
+      - pnpm-store:/pnpm-store
    working_dir: /workspaces/K12study
    command: sleep infinity
    environment:
@@ -26,6 +28,7 @@ services:
      K12STUDY_VECTOR_PORT: 19530
      K12STUDY_VECTOR_HTTP_PORT: 9091
      PYTHONUNBUFFERED: "1"
+      PNPM_STORE_DIR: /pnpm-store
    depends_on:
      - postgres
      - redis
@@ -151,6 +154,8 @@ services:
      - milvus-dev-data:/var/lib/milvus

 volumes:
+  frontend-node-modules:
+  pnpm-store:
  postgres-dev-data:
  redis-dev-data:
  nacos-dev-logs:
--- a/.gitignore
+++ b/.gitignore
@@ -12,7 +12,8 @@ referenceCode
 .DS_Store
 .tmp-run/
 .gitnexus
-
+.pnpm-store
+**/runtime

 **/target/
 **/node_modules/
--- a/docker/dev-common/docker-compose.public-services.yml
+++ b/docker/dev-common/docker-compose.public-services.yml
@@ -44,15 +44,24 @@ services:
    restart: unless-stopped
    environment:
      MODE: standalone
-      NACOS_AUTH_ENABLE: "false"
-      NACOS_AUTH_TOKEN: ${NACOS_AUTH_TOKEN:-azEyc3R1ZHktbmFjb3MtZGV2LXRva2VuLTIwMjY=}
+      # --- 鉴权配置 ---
+      NACOS_AUTH_ENABLE: "true"
+      NACOS_AUTH_SYSTEM_TYPE: nacos
+      NACOS_AUTH_TOKEN: ${NACOS_AUTH_TOKEN:-MDEyMzQ1Njc4OWFiY2RlZjAxMjM0NTY3ODlhYmNkZWY=}
      NACOS_AUTH_IDENTITY_KEY: ${NACOS_AUTH_IDENTITY_KEY:-serverIdentity}
      NACOS_AUTH_IDENTITY_VALUE: ${NACOS_AUTH_IDENTITY_VALUE:-security}
+      NACOS_AUTH_CACHE_ENABLE: "true"
+      NACOS_AUTH_ADMIN_ENABLE: "true"
+      NACOS_AUTH_CONSOLE_ENABLE: "true"
+      # Nacos 2.4+ / 3.x 不再提供默认管理员密码（不再是 nacos）。
+      # 首次开启鉴权后需初始化管理员密码，例如调用：
+      # POST /nacos/v1/auth/users/admin  with form-data: password=nacos
      TZ: ${TZ:-Asia/Shanghai}
      JVM_XMS: 256m
      JVM_XMX: 512m
      JVM_XMN: 128m
    ports:
+      - "${K12STUDY_REGISTRY_CONSOLE_PORT:-9080}:8080"
      - "${K12STUDY_REGISTRY_PORT:-8848}:8848"
      - "${K12STUDY_REGISTRY_GRPC_PORT:-9848}:9848"
      - "${K12STUDY_REGISTRY_RAFT_PORT:-9849}:9849"
@@ -111,52 +120,15 @@ services:
      - "${K12STUDY_GRAPH_PORT:-9669}:9669"
    networks:
      - k12study-dev-net
-  milvus-etcd:
-    image: quay.io/coreos/etcd:v3.5.5
-    container_name: k12study-dev-milvus-etcd
-    restart: unless-stopped
-    environment:
-      ETCD_AUTO_COMPACTION_MODE: revision
-      ETCD_AUTO_COMPACTION_RETENTION: "1000"
-      ETCD_QUOTA_BACKEND_BYTES: "4294967296"
-      ETCD_SNAPSHOT_COUNT: "50000"
-    command: etcd -advertise-client-urls=http://milvus-etcd:2379 -listen-client-urls=http://0.0.0.0:2379 --data-dir=/etcd
-    volumes:
-      - ${K12STUDY_RUN_DIR:-./runtime}/milvus/etcd:/etcd
-    networks:
-      - k12study-dev-net
-  milvus-minio:
-    image: minio/minio:RELEASE.2024-11-07T00-52-20Z
-    container_name: k12study-dev-milvus-minio
-    restart: unless-stopped
-    environment:
-      MINIO_ACCESS_KEY: ${K12STUDY_MINIO_ACCESS_KEY:-minioadmin}
-      MINIO_SECRET_KEY: ${K12STUDY_MINIO_SECRET_KEY:-minioadmin}
-    command: minio server /data
+  nebula-studio:
+    image: vesoft/nebula-graph-studio:latest
    ports:
-      - "${K12STUDY_MINIO_PORT:-9000}:9000"
-    volumes:
-      - ${K12STUDY_RUN_DIR:-./runtime}/milvus/minio:/data
-    networks:
-      - k12study-dev-net
-  milvus:
-    image: milvusdb/milvus:v2.4.8
-    container_name: k12study-dev-milvus
-    restart: unless-stopped
-    command: ["milvus", "run", "standalone"]
+      - "7001:7001"
+    environment:
+      - NGINX_PORT=7001
+      - LANG=en-US 
    depends_on:
-      - milvus-etcd
-      - milvus-minio
-    environment:
-      ETCD_ENDPOINTS: milvus-etcd:2379
-      MINIO_ADDRESS: milvus-minio:9000
-    ports:
-      - "${K12STUDY_VECTOR_PORT:-19530}:19530"
-      - "${K12STUDY_VECTOR_HTTP_PORT:-9091}:9091"
-    volumes:
-      - ${K12STUDY_RUN_DIR:-./runtime}/milvus/data:/var/lib/milvus
-    networks:
-      - k12study-dev-net
+      - nebula-graphd

 networks:
  k12study-dev-net:
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -25,7 +25,7 @@
  - 完成核心业务域数据模型定版，确保接口与代码开发有稳定数据契约。
 - 关键任务
  - 梳理多租户基础域（tenant/dept/user/role/menu）。
-  - 梳理课程域、题目与批改域、成就与推荐域、AI 知识域的数据关系。
+  - 梳理课程域、题目与批改域、成就域、AI 知识域的数据关系。
  - 定义 SQL 执行顺序、索引策略、跨 schema 依赖约束。
 - 验收产物
  - `docs/architecture/er-diagram.md`
--- a/docs/architecture/api-design.md
+++ b/docs/architecture/api-design.md
@@ -62,14 +62,7 @@
 - `GET /api/achievement/users/{userId}/records`
 - `GET /api/achievement/users/{userId}/progress`
 - `POST /api/achievement/events/trigger`
-
-### 3.4 推荐域（recommendation）
- `POST /api/recommendation/tasks`
- `GET /api/recommendation/tasks/{taskId}/items`
- `POST /api/recommendation/items/{itemId}/feedback`
- `GET /api/recommendation/effects/daily`
-
-### 3.5 AI 知识域（ai）
+### 3.4 AI 知识域（ai）
 - `POST /api/ai/knowledge/files`
 - `POST /api/ai/knowledge/files/{fileId}/sync`
 - `GET /api/ai/knowledge/sync-tasks/{taskId}`
@@ -78,5 +71,5 @@

 ## 4. API 阶段交付映射
 - M3：`auth + upms + file/message 基础扩展`
- M5：`course + question + achievement + recommendation + ai`
+- M5：`course + question + achievement + ai`
 - M6：前后端按冻结 API 完成联调，不新增破坏性变更。
--- a/docs/architecture/er-diagram.md
+++ b/docs/architecture/er-diagram.md
@@ -3,7 +3,7 @@
 - 基础域：租户、组织、用户、角色、菜单、文件。
 - 课程域：课程、章节、学习节点、知识点、学习进度。
 - 习题与批改域：题库、试卷、作业、提交、批改、错题与复习。
- 成就与推荐域：成就定义、用户成就、推荐任务、反馈、学习闭环。
+- 成就域：成就定义、用户成就与学习激励闭环。
 - AI 知识域：知识文件、同步任务、图谱实体/关系。

 ## 2. 核心关系图（基础域 + 教学主链路）
@@ -34,8 +34,6 @@ erDiagram

    USER_ACHIEVEMENT }o--|| ACHIEVEMENT : awarded
    USER_ACHIEVEMENT }o--|| SYS_USER : owner
-    RECOMMENDATION_TASK ||--o{ RECOMMENDATION_ITEM : produces
-    RECOMMENDATION_ITEM ||--o{ RECOMMENDATION_FEEDBACK : receives
 ```

 ## 3. AI 知识域关系图
@@ -72,6 +70,6 @@ erDiagram
 - `init/pg/ai/10_create_ai_tables.sql`

 ## 6. 设计建议
- 保持跨域依赖单向：`course/question/achievement/recommendation` 通过 `upms` 提供的主体信息关联。
+- 保持跨域依赖单向：`course/question/achievement` 通过 `upms` 提供的主体信息关联。
 - 涉及 AI 知识检索的数据优先走异步同步表，避免在线写链路阻塞。
 - 复杂业务报表优先通过事实表/汇总表落地，避免线上实时多表大 join。
--- a/docs/architecture/logical-view.md
+++ b/docs/architecture/logical-view.md
@@ -11,7 +11,7 @@
  - `ai-client`（Java 侧 AI 适配）
  - `python-ai`（AI 处理服务）
 - 业务域层（规划中）
-  - `course`、`question`、`achievement`、`recommendation`
+  - `course`、`question`、`achievement`
 - 数据与基础设施层
  - PostgreSQL（多 schema）
  - Redis（缓存、会话、热点）
@@ -30,21 +30,18 @@ graph TD
    GW --> COURSE[Course Service]
    GW --> QUESTION[Question Service]
    GW --> ACHIEVE[Achievement Service]
-    GW --> REC[Recommendation Service]

    AUTH --> PG[(PostgreSQL)]
    UPMS --> PG
    COURSE --> PG
    QUESTION --> PG
    ACHIEVE --> PG
-    REC --> PG

    AUTH --> REDIS[(Redis)]
    UPMS --> REDIS
    COURSE --> REDIS
    QUESTION --> REDIS
    ACHIEVE --> REDIS
-    REC --> REDIS

    QUESTION --> AICLIENT[AI Client]
    AICLIENT --> PYAI[Python AI]
@@ -63,7 +60,7 @@ graph TD
 - 教师发作业：题库/试卷/作业配置 -> 投放班级。
 - 学生提交：答题内容 + 文件（可选）。
 - 批改流程：自动批改 + 人工复核 -> 成绩汇总 -> 错题沉淀。
- 复习与推荐：复习计划 -> 推荐内容 -> 用户反馈 -> 闭环效果。
+- 复习闭环：复习计划 -> 复习执行 -> 效果回写。
 - 成就激励：事件触发 -> 规则命中 -> 成就发放/进度更新。

 ### 3.3 AI 知识链路
--- a/docs/plan/modules/gateway.md
+++ b/docs/plan/modules/gateway.md
@@ -1,7 +1,7 @@
 # 问题陈述
 将 `gateway` 从“仅转发 auth/upms 的静态网关”升级为全域统一接入层，负责鉴权透传、租户隔离防线、端侧能力边界控制（尤其小程序学生端）。
 ## 当前状态（已确认）
-* 架构定义中网关应承接 auth/upms/course/question/achievement/recommendation 多域入口。参考 `docs/architecture/logical-view.md (24-41)`。
+* 架构定义中网关应承接 auth/upms/course/question/achievement/ai 多域入口。参考 `docs/architecture/logical-view.md (24-41)`。
 * 现有网关路由仅配置 `auth` 与 `upms` 两条，且目标地址硬编码 localhost。参考 `backend/gateway/src/main/resources/application.yml (1-30)`。
 * `JwtRelayFilter` 仅做 token 校验并透传 `X-User-Id/X-Username/X-Display-Name/X-Tenant-Id/X-Dept-Id`。参考 `backend/gateway/src/main/java/com/k12study/gateway/filter/JwtRelayFilter.java (1-79)`、`backend/common/common-core/src/main/java/com/k12study/common/core/constants/SecurityConstants.java (1-13)`。
 * API 设计要求对外统一 `/api/*`，且后续需扩展到 course/question/ai。参考 `docs/architecture/api-design.md (1-82)`。
--- a/docs/plan/modules/question.md
+++ b/docs/plan/modules/question.md
@@ -1,11 +1,11 @@
 # 问题陈述
-将 `question` 拆分为可演进的习题/作业/批改核心域，并在同一计划中处理错题复习、费曼讲解、推荐闭环与小程序学生端作业可见规则。
+将 `question` 拆分为可演进的习题/作业/批改核心域，并在同一计划中处理错题复习、费曼讲解与小程序学生端作业可见规则。
 ## 当前状态（已确认）
 * 架构与 API 已定义 `question` 为核心业务域，覆盖题库、作业、提交、批改、复习。参考 `docs/architecture/api-design.md (42-61)`、`docs/architecture/logical-view.md (58-66)`。
 * 当前后端尚无 `question` 服务代码，能力主要体现在 `init/pg/question` 表结构。参考 `backend/pom.xml (11-20)`、`init/pg/question/10_create_question_tables.sql (1-1272)`。
-* SQL 已覆盖题库/作业/批改/错题/复习/讲解评估，并把推荐与画像并入 `question.rc_*`。参考 `init/pg/question/10_create_question_tables.sql (1041-1272)`。
+* SQL 已覆盖题库/作业/批改/错题/复习/讲解评估；当前阶段 `question` 不承载 recommendation 相关能力。参考 `init/pg/question/10_create_question_tables.sql (1-1272)`。
 * 复习策略已有租户级默认种子（E1-E6）。参考 `init/pg/question/20_init_question_seed.sql (8-56)`。
-* 功能清单对错题、变式题、费曼评估、复习提醒、推荐闭环都有明确诉求。参考 `docs/AI智能学习系统功能清单.md (11-24)`、`docs/AI智能学习系统功能清单.md (91-108)`。
+* 功能清单对错题、变式题、费曼评估、复习提醒都有明确诉求。参考 `docs/AI智能学习系统功能清单.md (11-24)`。
 ## 模块拆分与设计细节
 ### 1) 子模块边界
 * `question-bank`：题库、题目、题目知识点关联。
@@ -13,7 +13,6 @@
 * `question-grading`：批改任务、答案评分、错因标签、知识点分析。
 * `question-review`：错题沉淀、艾宾浩斯计划与执行。
 * `question-explanation`：费曼讲解提交、评估与维度评分。
-* `question-recommendation-bridge`：保留 `rc_*` 闭环数据（中期可再独立 recommendation 服务）。
 ### 2) 小程序学生端规则
 * 小程序仅面向学生，`assignment` 查询必须限制为“学生所在班级 + 已发布 + 节点类型为课堂练习/课后作业”。
 * 对应教师创建课程中的课件节点，不在学生端作业列表和详情返回。
@@ -22,17 +21,16 @@
 * 强化 `hw_assignment_target.target_ref_id` 的对象完整性（按 `target_type` 校验 class_id/student_id 存在且同租户）。
 * 补充“变式题生成任务”数据结构（任务、来源错题、生成题、命中策略），连接功能清单中的举一反三链路。
 * `gd_answer_grade` 继续作为统一批改结果主表，避免客观/主观分表回退。
-* 推荐闭环暂存于 `question` 时，需定义清晰子包边界，避免与习题核心耦合扩散。
 ### 4) 租户隔离策略
-* 所有 `hw_* / gd_* / rc_*` 读写统一按 `tenant_id` 强过滤。
-* 跨表关联（submission->student、assignment->class、recommendation->user）均执行租户一致性断言。
+* 所有 `hw_* / gd_*` 读写统一按 `tenant_id` 强过滤。
+* 跨表关联（submission->student、assignment->class）均执行租户一致性断言。
 * 对 AI 生成、图检索、向量检索调用记录 tenant 维度与来源对象，便于追溯越权风险。
 ## 问题点与风险
-* `question` 当前“超大域”承载习题+复习+讲解+推荐，若不先做包级拆分，后续维护成本会快速上升。
+* `question` 当前域内职责仍较重（习题+复习+讲解），若不先做包级拆分，后续维护成本会快速上升。
 * 目前无运行时代码，尽管 SQL 完整，但缺业务规则执行层，容易出现“表有字段、行为缺失”。
 * `target_ref_id` 弱关联容易引发错投放与越权读取。
 * 功能清单的变式题追踪链路在现有表中仍缺专门任务模型。
 ## 需确认的设计决策
-* 推荐相关 `rc_*` 是短期保留在 `question`，还是本阶段即拆到 `recommendation` 独立服务。
+* 当前阶段 recommendation 不纳入 `question`，`question` 仅交付习题/作业/批改/复习/讲解相关接口。
 * 变式题生成首期是否强依赖 AI 服务，或先以规则模板生成保障可交付。
 * 费曼评估通过阈值与回流规则（与系统文档口径）是否纳入一期强约束。