SpecialX
|
7545956202
|
docs(docs): v2.1 架构 spec 8 项调整
- Temporal 严格边界引入（AI 工作流 + Saga，CRUD 短事务禁用）
- CDC+Outbox 结合（Debezium Transaction Log Tailing，废弃轮询）
- DataLoader 强制（@key 解析器请求合并，消除 N+1）
- Router-Authorization 信任凭证（拒绝非 Router 的 GraphQL 请求）
- 外部 GraphQL + 内部 gRPC 边界明确
- Eager Invalidation + 乐观锁版本号回传
- Redis Pub/Sub 推送背板（边缘网关不挂 Kafka）
- ScopeToken 优化大规模 ID 列表传递
|
2026-07-14 22:55:56 +08:00 |
|
SpecialX
|
62682b9d61
|
docs(docs): 004 arch.db 二次校验 + 新增 v2 架构重设计 spec
004 修正 7 处与代码不符描述：
- proto 统计 / 包名 / core-edu gRPC service 数
- msg RPC 数 / data-ana RPC 数
- student-bff 模块数 / parent-bff 模块数
新增 v2 架构重设计 spec（996 行）：
- Apollo Federation BFF 联邦
- DataScope @requires 运行时解析
- iam 拆分 config-service
- content CQRS / ai 无状态化
- SSE 优先 / Temporal 不引入
Spec 自审修复 6 处问题：
- apollo-router 端口冲突 4000→4011
- Kafka topic 命名一致性
- CDC/Outbox 投影器职责分工
- 改动点数字 / 服务数 / 容器数计算
|
2026-07-14 21:25:37 +08:00 |
|
SpecialX
|
0b858d9069
|
docs(docs): 新增 0020 Portal Shell 架构文档(C4+4+1+ADR) + 设计 spec v2.1 + 更新 0010/004 指向新架构
|
2026-07-14 18:34:40 +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
|
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
|
68ddff1065
|
refactor(infra): 重构为 no-push 本地构建部署模式
CI / quality-go (push) Failing after 3s
CI / quality-proto (push) Failing after 2s
CI / quality-ts (push) Failing after 47s
CI / deploy (push) Has been skipped
- 删除 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
|
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 |
|