xiner/Edu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
97 Commits 1 Branch 8 Tags
b951229ede3740149c14801deade7ca9dfab9574
Commit Graph

56 Commits

Author SHA1 Message Date
SpecialX
b951229ede chore(teacher-bff): merge teacher-bff module into main 
Merge feat/teacher-bff-ai03 into main, conflicts resolved in favor of feature branch
 2026-07-10 19:00:13 +08:00
SpecialX
bfae2569e7 chore(api-gateway): merge api-gateway module into main 
Merge feat/api-gateway-ai01 into main, conflicts resolved in favor of feature branch
 2026-07-10 18:59:52 +08:00
SpecialX
7d11cc0eb0 chore(ai): merge ai module into main 
Merge feat/ai-ai12 into main, conflicts resolved in favor of feature branch
 2026-07-10 18:59:29 +08:00
SpecialX
bc2d0a107c chore(data-ana): merge data-ana module into main 
Merge feat/data-ana-ai11 into main, conflicts resolved in favor of feature branch
 2026-07-10 18:59:15 +08:00
SpecialX
5dae28a624 chore(msg): merge msg module into main 
Merge feat/msg-ai10 into main, conflicts resolved in favor of feature branch
 2026-07-10 18:59:01 +08:00
SpecialX
150105dd48 chore(content): merge content module into main 
Merge feat/content-ai09 into main, conflicts resolved in favor of feature branch
 2026-07-10 18:58:44 +08:00
SpecialX
ea59b9c9ca chore(core-edu): merge core-edu module into main 
Merge feat/core-edu-ai08 into main, conflicts resolved in favor of feature branch
 2026-07-10 18:58:28 +08:00
SpecialX
b255c94a77 chore(iam): merge iam module into main 
Merge feat/iam-ai06 into main, conflicts resolved in favor of feature branch
 2026-07-10 18:58:07 +08:00
SpecialX
4307f6b73c feat(api-gateway): 实现 W1-W8 网关硬化与 P2-P5 路由扩展 
依据 coord-final-decisions §3.8 W1-W8 裁决与
president-final-rulings §2.15/§2.16/§2.19 完整实现网关硬化：

- W1/W2: 错误码 GW_ 前缀 + ActionState 信封响应体
- W3: 全量替换为 log/slog 结构化日志
- W4: /readyz 并行 ping 9 下游 + 软失败规则
- W5: 7 个业务 Prometheus 指标 + /metrics 端点
- W6: tracer 资源属性补全（name/version/env/host）
- W7: DevMode=true && ENV=production panic 防护
- W8: 保持共享 downstream 熔断

P2 RS256 升级：接入 shared-go/jwks.Fetcher（TTL 5min）。
P2.7+P3-P5 路由扩展：student/parent/messages/dashboard。
文档同步：README/01/02/known-issues，arch.db 已更新。
质量校验：go vet + build + test 均通过。
 2026-07-10 18:15:48 +08:00
SpecialX
3fac472a57 chore(push-gateway): ai02 module updates - config, hub, ws, kafka, health, docs 2026-07-10 17:36:53 +08:00
SpecialX
dc0a6feec4 docs(docs): coord 仲裁 api-gateway 8 项 ISSUE（ARB-022） 
总裁确认采纳方案 A（双 /v1 前缀）。

- coord.md: 新增 §24 ARB-022（api-gateway 8 项 ISSUE 仲裁）
- coord.md: §24.4 ISSUE-003 方案 A 裁决 + 总裁确认记录
- matrix.md: §5 路径前缀修正为双 /v1（方案 A）
- api-gateway_issue.md: §2 状态更新为已裁决

AI: coord
 2026-07-10 17:07:15 +08:00
SpecialX
855f35f84b chore: merge feat/api-gateway-ai01 review docs into main 2026-07-10 16:53:08 +08:00
SpecialX
8e91039896 docs(api-gateway): 补充完整架构问题记录与裁决核查 
完成api-gateway模块边界确认，添加W1-W8裁决遵循情况核查与架构不一致问题梳理
汇总8项待coord仲裁的issue，包含模块契约、依赖、版本、文档等问题
 2026-07-10 16:41:57 +08:00
SpecialX
c179af64a6 docs(docs): coord 完成 15 模块 issue 仲裁与基础设施同步 
coord.md 新增 ARB-019/020/021 三章仲裁章节，修正 ARB-001。

- coord.md: 新增 ARB-019/020/021（student/parent/admin-portal 24 项）
- coord.md: 修正 ARB-001（admin P2 预留/schema 文件名/classes 数据源）
- 004 §4: 依赖图加 PBFF→DataAna+Msg
- 004 §7.2: push-gateway→Redis 软失败标注
- 004 §11.4: 错误码前缀矩阵（11 服务+i18n key）
- 004 §11.5: ActionState 信封规范（降级模式方案 B）
- matrix §1: 依赖矩阵加 PBFF 边
- matrix §2: 移除 api-gateway 为 iam gRPC 消费方
- matrix §4: admin-portal→teacher-bff
- matrix §5: 移除 /sse+鉴权头统一
- matrix §6: 错误码表补 i18n key 列
- 15 个 issue.md: 仲裁结论回写
- push-gateway_contract: 移除 /sse+鉴权头改 X-Internal-Token
- packages/contracts: 新建包 ADMIN_* 权限点常量

AI: coord
 2026-07-10 16:30:51 +08:00
SpecialX
df62ffc176 Merge worktree branch merge-15-modules-to-main-5ug5xJ 2026-07-10 15:28:20 +08:00
SpecialX
88f6822473 docs: update api-gateway workline and contract based on new arbitration 
update workline to detail full P2-P6 tasks with clear milestones and dependencies
revise contract to correct route prefix, JWKS method and dependency descriptions
clean up outdated issue content
 2026-07-10 15:06:22 +08:00
SpecialX
06e0f9139b feat: auto committed 2026-07-10 15:06:09 +08:00
SpecialX
5e0e20b1ce feat: auto committed 2026-07-10 15:05:58 +08:00
SpecialX
06a646ea4e feat: auto committed 2026-07-10 15:05:55 +08:00
SpecialX
21530dc7f6 feat: auto committed 2026-07-10 15:05:52 +08:00
SpecialX
b82593aac2 feat: auto committed 2026-07-10 15:05:50 +08:00
SpecialX
c09d6fb7d2 feat: auto committed 2026-07-10 15:05:44 +08:00
SpecialX
033057a302 feat: auto committed 2026-07-10 15:05:37 +08:00
SpecialX
60d7173545 docs(docs): 维护历史文档声明+workline重写为全并行模式+coord措辞修复 2026-07-10 14:13:47 +08:00
SpecialX
3852873964 docs(docs): 新增 AI 协作文档使用指南 2026-07-10 14:09:27 +08:00
SpecialX
5144ec7292 docs(docs): 更新分支策略为 17 长期分支 2026-07-10 14:07:02 +08:00
SpecialX
9ba368477d refactor(docs): 移除 ai07 classes 合并到 core-edu，16 AI 降为 15 AI 2026-07-10 14:04:49 +08:00
SpecialX
6051f84a65 docs: 恢复分支开发模式 - AI 不切换分支,默认多AI协作,经验沉淀不标注AI身份 2026-07-10 13:46:47 +08:00
SpecialX
f15912c7ee docs: 文档体系修正 - 模块边界强化与按需阅读架构 2026-07-10 13:33:31 +08:00
SpecialX
faaaf29f67 docs: ai 协作文档体系重构与多 ai 仲裁结果落地 
1.AI 协作文档体系重构(objections/worklines/contracts+matrix.md)

2.coord 仲裁文档(final-decisions/cross-review/final-rulings/orchestration)

3.各服务 01/02 文档补全

4.共享包初始化(shared-ts/shared-go/hooks/ui-components/ui-tokens)

5.Proto 契约补全

6.004 架构影响地图更新

7.端口分配表

8.设计规格文档
 2026-07-10 12:58:22 +08:00
SpecialX
2a2a56f541 docs: ai 协作文档体系重构与多 ai 仲裁结果落地 
1.AI 协作文档体系重构(objections/worklines/contracts+matrix.md)

2.coord 仲裁文档(final-decisions/cross-review/final-rulings/orchestration)

3.issues.md 问题记录(ISSUE-001~035)

4.各服务 01/02 文档补全

5.共享包初始化(shared-ts/shared-go/hooks/ui-components/ui-tokens)

6.Proto 契约补全

7.004 架构影响地图更新

8.端口分配表

9.设计规格文档
 2026-07-10 12:55:49 +08:00
SpecialX
fd5b6e19ae docs(data-ana): ai06 补充 AI Agent 身份标注（§14.7） 2026-07-09 17:30:49 +08:00
SpecialX
0a71b02e04 fix: code compliance audit and fix across all services
Some checks failed
CI / quality-ts (push) Failing after 48s
Details
CI / quality-go (push) Failing after 4s
Details
CI / quality-proto (push) Failing after 2s
Details
CI / deploy (push) Has been skipped
Details 
NestJS (6 services): implement @RequirePermission decorator with
SetMetadata+Reflector, register APP_GUARD globally, fix as assertions
to type guards, add explicit return types, fix import type for express,
fix /metrics implicit any, replace native Error with ApplicationError,
remove typeorm remnants, register LifecycleService.

teacher-bff: add logger, ApplicationError, GlobalErrorFilter, forward
real userId to downstream, log downstream failures, migrate health
controller to shared/health.

Go (2 services): interface to any, doc comments, CORS dev whitelist,
JWT secret fail-fast, push-gateway internal API auth, metrics and
readyz endpoints, remove dead code.

Python (2 services): lifespan return type, dev_mode to bool, data-ana
APIRouter, ai POST body model, ClickHouse async wrapping.
 2026-07-09 17:28:27 +08:00
SpecialX
834e2c61fd docs(api-gateway): ai01 阶段1+2 模块理解确认书与架构设计文档 
阶段1交付：services/api-gateway/docs/01-understanding.md
- 8节内容：架构位置/限界上下文/契约/技术栈/阶段归属/黄金模板对齐审计
- 审计13项差距（3高：缺/metrics、/readyz stub、auth.go死代码；4中：log/slog缺失、go.mod版本不匹配、HS256待升RS256、DevMode风险；6低）

阶段2交付：services/api-gateway/docs/02-architecture-design.md
- 9节内容：内部分层图/路由表矩阵9下游/限流策略表/熔断阈值表/JWT RS256流程含JWKS缓存/CORS白名单/请求ID注入/metrics 7项指标/P0-P3实施优先级

同步更新 docs/troubleshooting/known-issues.md 工作经验日志（追加ai01条目）

AI Agent: ai01 (api-gateway/push-gateway)
Branch: main
Coordinator: coord
 2026-07-09 17:21:03 +08:00
SpecialX
f1e466a772 fix(infra): resolve NestJS dist build and Prometheus target issues
Some checks failed
CI / quality-go (push) Failing after 5s
Details
CI / quality-proto (push) Failing after 3s
Details
CI / deploy (push) Has been skipped
Details
CI / quality-ts (push) Failing after 50s
Details 
NestJS: disable incremental in 6 services tsconfig.json to fix dist
not emitted when nest-cli deleteOutDir conflicts with tsc tsbuildinfo.
classes/iam: import HealthModule in AppModule to fix /healthz 404.
classes: rewrite HealthController to Drizzle getDb from TypeORM DI.
teacher-bff: add /metrics endpoint for Prometheus scraping.
infra: add node/mysql/redis exporters to observability profile.
mysql-exporter v0.15.1 uses command-line flags not DATA_SOURCE_NAME.
prometheus: enable web.enable-lifecycle for hot reload.
 2026-07-09 15:12:15 +08:00
SpecialX
959d58a95d docs: add full-stack runbook and one-click scripts
Some checks failed
CI / quality-ts (push) Failing after 51s
Details
CI / quality-go (push) Failing after 3s
Details
CI / quality-proto (push) Failing after 2s
Details
CI / deploy (push) Has been skipped
Details 
start-all/stop-all/health-check/test-cdc PowerShell scripts.

Compatible with PowerShell 5.1 (ASCII only, no emoji).
 2026-07-09 13:47:46 +08:00
SpecialX
d8dab70406 feat(infra): add OTel auto-instrumentations across all services
Some checks failed
CI / quality-proto (push) Failing after 2s
Details
CI / deploy (push) Has been skipped
Details
CI / quality-ts (push) Failing after 1m11s
Details
CI / quality-go (push) Failing after 5s
Details 
NestJS 6 services use getNodeAutoInstrumentations().

Python 2 services use FastAPIInstrumentor. Go 2 services use otelgin.
 2026-07-09 13:25:46 +08:00
SpecialX
1f901c5b20 feat(data-ana): implement complete CDC pipeline MySQL to ClickHouse 
Debezium + Kafka + aiokafka consumer with table routing.

E2E verified: MySQL INSERT to ClickHouse upsert.
 2026-07-09 13:02:59 +08:00
SpecialX
958b17c9d8 feat(infra): p6 hardening - metrics collection and registry mirror 
- 4 services add collectDefaultMetrics for process metrics
- docker-compose.yml images prefixed with docker.m.daocloud.io
- Prometheus v0.51.0 (nonexistent) fixed to v2.51.0
- Grafana port remapped 3000 to 3030 to avoid teacher-portal conflict
- ClickHouse edu_analytics database initialized
- known-issues.md documents 7 new P6 scenario-to-rule mappings
 2026-07-09 12:29:36 +08:00
SpecialX
566060fade feat(infra): p6 hardening - observability and deploy compose 
- 5 NestJS services add /metrics endpoint via app.getHttpAdapter()
- prometheus.yml scales to 8 services with rule_files and alertmanager
- monitoring compose replaces blackbox with Loki+Promtail
- Grafana datasource adds Loki
- docker-compose.deploy.yml scales to 11 services
- deploy.env.example completes Neo4j/ES/ClickHouse/LLM vars
- teacher-bff adds health.controller
- CI removes continue-on-error on lint step
- teacher-portal lint script changed to eslint src
 2026-07-09 10:21:06 +08:00
SpecialX
3ca654619f chore(infra): 配置ESLint 9 flat config并恢复lint-staged集成 
- 新增 eslint.config.js（ESLint 9 flat config 格式）
- 安装 @eslint/js + typescript-eslint + eslint-config-prettier
- 6 个 TS 服务 lint 脚本：eslint src --ext .ts → eslint src
- lint-staged 恢复 eslint --fix
- .gitignore 忽略 docker-compose.minimal.override.yml
- known-issues.md 新增 P6 硬化条目
 2026-07-09 09:14:44 +08:00
SpecialX
a70a74207e feat(ai): 完善AI网关服务并添加LLM降级模式 
config.py 加openai_api_key/base_url/dev_mode

新建llm_client.py httpx异步调OpenAI REST API

main.py 业务路由加/ai前缀+降级模式+readyz端点

Gateway添加/notifications和/ai路由

docs: known-issues记录P5三服务经验
 2026-07-09 09:09:27 +08:00
SpecialX
5f18821302 feat(api-gateway): 添加content服务代理路由 
main.go添加textbooks/chapters/knowledge-points/questions四组路由

config.go新增ContentServiceURL字段

docs: known-issues记录P4 content端到端验证经验
 2026-07-09 08:52:30 +08:00
SpecialX
beb204c00f docs(docs): 记录 P3 core-edu 端到端验证经验与场景映射 
core-edu 段新增 6 行: datetime 转换/Kafka 非阻塞/相对 import/身份头/健康检查/Outbox 验证
api-gateway 段新增 3 行: 路由注册位置/多服务路由扩展/DEV_MODE 环境变量
经验日志追加 2026-07-09 P3 条目
 2026-07-09 08:04:00 +08:00
SpecialX
2c7afe59ef feat(teacher-portal): 实现登录页侧边栏路由组与真实JWT集成 
- lib/auth.ts: localStorage token 存储 + login/logout

- app/login: 登录表单页

- components/AppShell: 视口驱动侧边栏 + 路由保护

- app/(app)/layout: 路由组布局套 AppShell

- app/(app)/dashboard: 聚合统计卡片页

- app/(app)/classes: 迁移 CRUD 改用真实 JWT

- app/page.tsx: 根路径重定向

- known-issues.md: 记录 P2 经验
 2026-07-09 00:58:42 +08:00
SpecialX
d92cdda727 docs(docs): 记录 P1 端到端验证经验与 IAM 场景映射 
在 2.3 iam 分区补充 5 条场景映射（ESM DI/Drizzle API/健康检查/Gateway 身份传递/DEV_MODE 登录）；工作经验日志追加 P1 端到端验证完整记录。
 2026-07-09 00:26:28 +08:00
SpecialX
68ddff1065 refactor(infra): 重构为 no-push 本地构建部署模式
Some checks failed
CI / quality-go (push) Failing after 3s
Details
CI / quality-proto (push) Failing after 2s
Details
CI / quality-ts (push) Failing after 47s
Details
CI / deploy (push) Has been skipped
Details 
- 删除 6 个分散 workflow（ci-ts/ci-go/ci-proto/ci-py/docker/deploy）
- 合并为单个 ci.yml：3 个 quality job 并行 + deploy job 串行
- 全部使用官方镜像（node:22-alpine/golang:1.22-alpine/bufbuild/buf/docker:25-git）
- deploy job 用 DooD 模式挂载 /var/run/docker.sock
- docker-compose.deploy.yml 改用 build: 替代 image:（no-push）
- 新增 docker-compose.tools.yml 一次性预拉所有 CI 镜像
- 支持 workflow_dispatch 指定 commit_sha 回滚
- 更新 project_rules §15 与 cicd-runbook.md 为 no-push 模式
- 新增设计文档 docs/superpowers/specs/2026-07-08-cicd-no-push-local-build-design.md
 2026-07-08 17:12:57 +08:00
SpecialX
a1d7fcfd71 docs(docs): 新增 CICD 参考实现规范
Some checks failed
CI TypeScript / quality (push) Failing after 6s
Details
CI TypeScript / arch-scan (push) Has been skipped
Details
CI TypeScript / docker-build (map[context:. dockerfile:apps/teacher-portal/Dockerfile name:teacher-portal]) (push) Has been skipped
Details
CI TypeScript / docker-build (map[context:. dockerfile:services/classes/Dockerfile name:classes]) (push) Has been skipped
Details
Docker Build & Push / build-push (map[context:. dockerfile:apps/teacher-portal/Dockerfile name:teacher-portal]) (push) Failing after 3s
Details
Docker Build & Push / build-push (map[context:. dockerfile:services/classes/Dockerfile name:classes]) (push) Failing after 10s
Details
Docker Build & Push / build-push (map[context:./services/api-gateway dockerfile:services/api-gateway/Dockerfile name:api-gateway]) (push) Failing after 8s
Details
CI Go / quality (push) Failing after 1m4s
Details
CI Go / docker-build (push) Has been skipped
Details 
- project_rules §15.7: 参考项目位置 + 关键配置点（container/runner 标签/部署方式/网络）

- cicd-runbook §10: 参考项目对照表（配置项、关键差异、修改流程、冲突处理）

- 修正 cicd-runbook runner 标签：self-hosted,deploy → ubuntu-latest
 2026-07-08 16:12:45 +08:00
SpecialX
ae460e61a3 docs(docs): 记录重定向循环与CICD配置经验 
- 新增场景映射：尾斜杠重定向循环、开发模式鉴权旁路

- 工作经验日志：重定向循环修复、CI/CD 完整配置
 2026-07-08 15:16:00 +08:00
SpecialX
d19285a977 docs(docs): 新增本地启动/多AI协作/CI-CD 使用手册 
- local-dev-runbook.md: 8 章本地启动手册（环境依赖/端口分配/开发模式/生产模式/裸机运行/常见问题）

- multi-ai-collaboration.md: 15 章多AI协作文档（角色定义/模块分工/分支策略/PR流程/审核合并/跨模块变更）

- cicd-runbook.md: 10 章 CI/CD 使用手册（架构总览/一次性配置/日常使用/镜像管理/部署验证/回滚）

- README.md: 文档清单新增三个 runbook 链接
 2026-07-08 15:14:30 +08:00