SpecialX
61d824924a
fix: 修复集成测试中发现的全部 bug — 15 服务端到端验证通过
...
修复涵盖 6 大类问题：
1. api-gateway
- 路径前缀剥离 /api 而非 /api/v1，保留下游 /v1/ controller 前缀
- JWKS URL 默认值修复
- publicPaths 白名单对齐 /v1/iam/*
2. iam
- iam.module.ts exports 补充 PermissionCacheService 和 IamRepository
- main.ts resolveProtoPath() 多路径探测 proto 文件
3. core-edu
- app.module.ts AuthMiddleware 全局注册
4. BFF 层 GraphQL 端点（teacher-bff / parent-bff / student-bff）
- teacher-bff: mock dataScope OWN→SELF 对齐 GraphQL enum；WHATWG Request header .get() 提取
- parent-bff: handleNodeRequestAndResponse 不存在 → 直接 yoga(req,res)；WHATWG Request header .get() 提取
- student-bff: auth.resolver 移除 ActionState 信封返回扁平对象；WHATWG Request header .get() 提取
5. ai
- Kafka 事务降级 + 10s 超时
- gRPC 拦截器降级
- dev mode 禁用事务模式
6. 前端 + 共享包
- teacher-portal: MF 插件条件实例化 + transpilePackages + extensionAlias
- ui-components: error-boundary.tsx 添加 use client
- ui-tokens: tailwind-theme.css 移除 @layer base
- shared-ts: 导出从源码改为 dist 编译产物；OutboxModule global:true
7. infra
- .gitignore 补充 keys/ *.pem *.key secrets/ 排除规则
- infra/init-sql/02-all-services-schema.sql 36 张表 DDL
验证结果：
- TS typecheck: 19 个 workspace 项目全部通过
- Go vet + Ruff: 通过
- 15 服务全部启动成功
- 3 个 BFF GraphQL 端点 + 4 个前端页面全部 200
- Gateway → iam → core-edu 端到端链路验证通过
AI identity: trae-main（集成测试修复会话）
2026-07-11 01:41:46 +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
0a71b02e04
fix: code compliance audit and fix across all services
...
CI / quality-ts (push) Failing after 48s
CI / quality-go (push) Failing after 4s
CI / quality-proto (push) Failing after 2s
CI / deploy (push) Has been skipped
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
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
421edd8a41
feat(data-ana): 完善学情诊断服务并添加ClickHouse降级模式
...
config.py ClickHouse连接改可选+加DEV_MODE/kafka_brokers
clickhouse_client.py 降级模式: host为空时返回None
main.py 端点先查ClickHouse降级返回骨架数据+新增errorbook
新增clickhouse-init.sql创建宽表和错题表
Gateway添加/analytics路由
2026-07-09 08:58:39 +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
4f539b50dd
feat(api-gateway): 添加 core-edu 服务代理路由
...
main.go 新增 exams/homework/grades 三组路由(无尾斜杠+通配符)
config.go 新增 CoreEduServiceURL 字段默认 localhost:3004
删除死代码 internal/routing/routing.go(从未被 main 引用)
验证: GET /exams/class/:id 200, POST /exams 201, 链路全通
2026-07-09 08:02:39 +08:00
SpecialX
e5902ca2b3
fix(api-gateway): 修复尾斜杠重定向循环与 DEV_MODE 旁路
...
- main.go: 禁用 RedirectTrailingSlash，为 classes/iam/teacher 双注册无尾斜杠与通配符路由
- auth.go: DEV_MODE=true 时接受 Bearer dev-token 注入开发用户
- config.go: 新增 DevMode 配置项与 getEnvBool 工具
- page.tsx: 开发模式请求携带 Authorization: Bearer dev-token
- .env.example: 添加 DEV_MODE=false 默认值与生产警告
2026-07-08 15:11:47 +08:00
SpecialX
524204d30a
feat(p2): identity layer with IAM service and Teacher BFF
...
P2 阶段交付物：
- services/iam: 完整身份认证服务（users/roles/permissions/refresh_tokens 6 表 schema）
- register/login/refresh/getUserInfo 4 个核心 API
- bcrypt 密码哈希 + JWT 双 Token（access + refresh）
- 复用 classes 黄金模板（errors/observability/middleware 三件套）
- services/teacher-bff: 教师聚合 BFF
- Promise.allSettled 并行聚合 IAM + classes 数据
- /teacher/dashboard 单一聚合端点
- packages/shared-proto/proto/iam.proto: IamService 契约（Register/Login/RefreshToken/GetUserInfo）
- api-gateway: 新增 IamServiceURL/TeacherBffURL 配置 + /iam/* + /teacher/* 路由
2026-07-08 01:37:29 +08:00
SpecialX
2ba4250165
feat(p1): complete P1 foundation stage
...
CI Go / test (push) Has been cancelled
CI Proto / lint (push) Has been cancelled
CI Python / test (push) Has been cancelled
CI TypeScript / test (push) Has been cancelled
- 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
