SpecialX
895a060491
feat(teacher-bff): admin 命名空间 + 5 个 gRPC client + health probes + merge-resolvers + nextstep 文档
2026-07-14 16:00:46 +08:00
SpecialX
81a539b9ab
chore(deps): 统一依赖管理 - pnpm 11 + node:22 + golang:1.25 + python:3.12 + shared-* 集中化
...
CI / quality-ts (push) Failing after 6s
CI / quality-go (push) Failing after 25s
CI / quality-proto (push) Failing after 6s
CI / deploy (push) Has been skipped
- Node.js 统一到 node:22-alpine,Go 统一到 golang:1.25-alpine,Python 统一到 python:3.12-slim
- pnpm 升级到 11.13.0(corepack),新增 allowBuilds 白名单解决 ERR_PNPM_IGNORED_BUILDS
- 新增 packages/shared-py 集中 Python 共享依赖,shared-ts 补充 graphql-yoga/prom-client
- api-gateway 修复 go.mod 的 shared-go 依赖 + Dockerfile 改用 repo 根作 context
- Python 服务(data-ana/ai)Dockerfile 改用 repo 根作 context + 声明 uv workspace sources
- 16 个服务的 Dockerfile + CI + docker-compose.tools.yml 全部对齐版本矩阵
- known-issues.md 沉淀 9 条 pnpm 11 / uv workspace / Go shared-go 迁移经验
- 验证:4 服务完全成功(api-gateway /healthz 200),其余 install 成功(build 失败为预存 TS 错误)
2026-07-14 12:04:49 +08:00
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
99155a5ea1
feat(teacher-bff): 完整实现 teacher-bff GraphQL 聚合层
...
包含 clients/graphql/middleware、health probes、shared-ts contracts 等
2026-07-10 19:10:07 +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
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
f1e466a772
fix(infra): resolve NestJS dist build and Prometheus target issues
...
CI / quality-go (push) Failing after 5s
CI / quality-proto (push) Failing after 3s
CI / deploy (push) Has been skipped
CI / quality-ts (push) Failing after 50s
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
d8dab70406
feat(infra): add OTel auto-instrumentations across all services
...
CI / quality-proto (push) Failing after 2s
CI / deploy (push) Has been skipped
CI / quality-ts (push) Failing after 1m11s
CI / quality-go (push) Failing after 5s
NestJS 6 services use getNodeAutoInstrumentations().
Python 2 services use FastAPIInstrumentor. Go 2 services use otelgin.
2026-07-09 13:25:46 +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
6215f4e21f
feat(teacher-bff): 添加考试作业成绩聚合端点
...
env.ts 新增 CoreEduServiceUrl
teacher.service 新增 listExamsByClass/listHomeworkByClass/listGradesByExam 三个聚合方法
teacher.controller 暴露 3 个 GET 端点:
/teacher/classes/:classId/exams
/teacher/classes/:classId/homework
/teacher/exams/:examId/grades
验证: 3 端点全部 200 返回 core-edu 数据
2026-07-09 08:05:24 +08:00
SpecialX
b2c2f6e567
feat(teacher-bff): 添加视口聚合端点 + 修复身份头读取
...
- 新增 GET /teacher/viewports 聚合 IAM 视口配置
- 修复 controller 从 x-user-id header 读取身份(替代 AuthenticatedRequest)
- 添加 zod + @types/express 依赖
2026-07-09 00:49:24 +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