ROADMAP / 06

实施路线

先消除组织歧义,再拆代码;先建立门禁,再扩大并行度。路线以降低冲突和发布风险为目标,不追求一次性重写。

01

0–2 周

建立真值与冻结重复建设

NOW
  • developer portal v1
  • 19 组织仓 machine manifest
  • apps-* 归并决策
  • 公共/运营路由 ownership
  • 身份与核心仓最小 CI
02

2–6 周

拆高冲突文件,守住外部契约

NEXT
  • Booking/行情巨型文件拆域
  • data-sources 与 BBS 拆模块
  • 官网首页配置化
  • im-core 路由生成清单
  • 共享 token 包与生成器
03

6–10 周

打通跨仓契约与 UI CI

PLANNED
  • 内容/预约 contract tests
  • 两套 iOS/IM 动态 smoke
  • Web a11y + visual
  • miniapp bundle + asset integrity
  • 量化 data contract + determinism
04

持续

门户自动化与平台治理

OPERATE
  • manifest 自动聚合
  • 文档 lifecycle
  • SLO/错误预算
  • 依赖与弃用看板
  • 部署/回滚证据可检索

PRIORITY BACKLOG

架构 review 结论转成可执行工作

01P0

确立唯一产品真值

apps-* 三个原型与正式官网/NodeBB 的职责重叠。先冻结双轨新增,完成能力差异表后归档或转为门户内容源。

02P0

补齐身份核心的验证底座

reits-auth 是所有非原生客户端的统一登录门面,但当前没有测试和 CI,7 种验证类型仅 1 种完成。认证状态机、scope registry、JWKS 和撤销必须先闭环。

03P0

拆分两座新增巨型单体

public-booking-platform 的 34,711 行 server.js 承载 188 条 API 分支,trading-data-source 的后台和服务器分别集中在 3,371 行 App.vue 与 6,126 行 server.go,已成为多人协作热点。

04P0

把规划仓与运行仓分开标识

quant-platform 当前只有 README,但已被量化 iOS 当作 live 后端目标;miniapp-open-platform 也只有 4/33 个目标页面。门户必须区分 implemented、contracted、planned,禁止把路线图当已上线能力。

05P1

统一两套 iOS 产品的共享边界

Matrix X Chat 与 Matrix Quant iOS 都维护 IM、小程序和设计 token。应共享协议、SDK 和 token source,不复制业务实现;产品导航与发布节奏保持独立。

06P1

用机器清单替代人工猜测

每仓提交 repository.manifest.json:owner、实现状态、路由、依赖、数据契约、UI surface、测试和 SLO,由开发者门户聚合并与 Gitea 组织清单做差异检测。

07P1

把公共、运营与控制面分开

官网 76 个 operations 页面与预约平台大量 /api/ops 路由说明内部控制面正在侵入公共体验。应建立独立权限、owner、部署和故障半径。

08P1

把成熟门禁复制到所有核心仓

Matrix X Chat 有 47 条工作流,Matrix Quant iOS 也有完整 CI;但预约平台、交易数据、身份和公共 SDK 没有自动工作流。统一最小门禁:lint、type/build、unit、contract、a11y、visual、security。

09P1

收敛文档与刀法生命周期

知识库 448 份文档,预约平台另有 179 份阶段文档。增加 active/superseded/archived、owner、代码锚点和替代链接,门户只展示 active 真值。

TARGET STATE

完成后的样子

30 秒

新人能找到项目 owner、入口、依赖与本地启动方式

1 份

每个跨仓契约只有一个版本化真值

0 猜测

AI 从 manifest 读取范围、状态和门禁

可回滚

每次生产变更都带制品、迁移和回滚证据