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

35 Commits

Author SHA1 Message Date
SpecialX
8f21ca6a68 chore(parent-bff): merge parent-bff module into main 
Merge feat/parent-bff-ai05 into main, conflicts resolved in favor of feature branch
 2026-07-10 19:00:29 +08:00
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
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
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
a7d8f92227 feat: auto committed 2026-07-10 15:06:12 +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
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
beedbaf686 docs: 同步 P6 工作日志、runbook 与服务 README 
- known-issues.md: 追加 9 条 P6 工作经验日志，更新 arch-scan 经验
- post-p6-followup.md: 新增 P6 后续工作手册 runbook
- iam/core-edu/content/msg README: 补充健康检查端点说明
 2026-07-08 12:53:05 +08:00
SpecialX
bc3176cb05 fix(docs): 004 架构图补充分层/领域双视角与视口四层模型 
- 1.1a 技术分层视角：用户层标注改为场景域用户
- 1.1b 业务领域视角：新增 6 领域 subgraph（D1-D6）
- 1.2 服务清单新增业务领域列
- 5.4 新增视口四层模型章节（L1-L4 + 场景域 BFF 复用策略）
 2026-07-08 12:50:13 +08:00
SpecialX
e9ea34fe53 feat(p6): production hardening with circuit breaker, backup, monitoring and chaos engineering
Some checks failed
CI Go / test (push) Has been cancelled
Details
CI Python / test (push) Has been cancelled
Details
CI TypeScript / test (push) Has been cancelled
Details
CI Proto / lint (push) Failing after 8m7s
Details 
P6 生产硬化阶段交付物（46 文件）：

## 1. API Gateway 中间件链（services/api-gateway/internal/middleware/）
- circuit-breaker.go: gobreaker v2 熔断器（5s 窗口/50% 错误率/30s OPEN→HALF_OPEN）
- ratelimit.go: 令牌桶限流（sync.Map + cleanup goroutine，默认 100rps/20 burst）
- cors.go: CORS 中间件（CORS_ORIGINS 环境变量）
- recovery.go: panic 恢复 + uuid request_id
- security.go: 安全头 + 请求体 10MB 限制
- requestid.go: 请求 ID 注入
- health/health.go: /healthz + /readyz 健康检查
- main.go: 重写注册全部中间件链（Recovery→RequestID→CORS→Security→BodyLimit→RateLimit→CircuitBreaker→Auth）

## 2. 基础设施硬化（infra/）
- backup/backup-mysql.sh: MySQL 全量备份（mysqldump+gzip，按服务独立）
- backup/restore-mysql.sh: 恢复脚本
- backup/backup-cron.sh: cron 调度入口（5 服务批量备份）
- alertmanager/alertmanager.yml: 告警路由（webhook + 邮件示例）
- prometheus/rules.yml: 8 条告警规则（服务可用性/性能/资源 3 组）
- grafana/dashboards/microservices-overview.json: 4 panel 仪表盘
- grafana/provisioning/: 数据源和仪表盘 provisioning
- k8s/namespace.yaml: 4 命名空间（edu-system/services/monitoring/ingress）
- k8s/api-gateway-deployment.yaml: Deployment + Service 骨架
- chaos/experiments.yaml: 3 个 Litmus 混沌实验（pod-kill/network-latency/disk-fill）
- docker-compose.monitoring.yml: 监控栈 profile
- security/secrets.example.env: 8 项密钥占位符
- security/waf-rules.conf: ModSecurity WAF 规则骨架

## 3. 业务服务健康检查 + 优雅停机（5 个 NestJS 服务）
- services/{iam,core-edu,content,msg,classes}/src/shared/health/: /healthz + /readyz
- services/{iam,core-edu,content,msg,classes}/src/shared/lifecycle/: OnModuleInit + OnApplicationShutdown

## 4. Python 服务健康检查
- services/{ai,data-ana}/src/health/health.py: FastAPI APIRouter

## 5. 运维文档
- docs/architecture/runbooks/p6-hardening.md: P6 总览 Runbook（9 章节）
- docs/architecture/runbooks/incident-response.md: 事件响应手册（5 章节）
- docs/architecture/004-p6-addendum.md: 004 架构补记 P6 章节
- docs/troubleshooting/known-issues-p6-addendum.md: 15 条 P6 场景→技术映射

## 验收信号
- RPO ≤ 15min（MySQL 备份 + binlog PITR）
- RTO ≤ 30min（K8s 滚动更新 + DNS 切换）
- P99 ≤ 500ms（熔断 + 限流 + 缓存）
- 熔断器错误率 > 50% 触发 OPEN
- 限流 100rps/20 burst
- 备份保留 7 天
- 混沌实验每月 1 次
 2026-07-08 02:16:58 +08:00
SpecialX
2ba4250165 feat(p1): complete P1 foundation stage
Some checks failed
CI Go / test (push) Has been cancelled
Details
CI Proto / lint (push) Has been cancelled
Details
CI Python / test (push) Has been cancelled
Details
CI TypeScript / test (push) Has been cancelled
Details 
- monorepo: pnpm workspace + go.work + pyproject.toml + commitlint/husky
- infra: docker-compose (minimal + full profiles) + init-sql + prometheus
- arch-scan: multi-language scanner skeleton (TS/Go/Python/Proto)
- shared-proto: buf v2 + classes.proto (ClassService CRUD contract)
- api-gateway: Go/Gin + JWT HS256 auth + reverse proxy + request ID
- classes: NestJS golden template (error system + observability + middleware + CRUD + tests)
- teacher-portal: Next.js + paper-feel UI design system
- CI/CD: 4 workflows (go/ts/py/proto)
- docs: migration guide + project_rules + coding-standards + git-workflow + ui-design-system + 004 + 9 module READMEs + known-issues + spec/plan migration + roadmap
 2026-07-07 23:39:37 +08:00