阅读时间:1 分钟
0 字

文档地图 ​

本页按阅读目标给出最短路径。平台当前处于架构设计阶段;只有文档站可以运行,其余服务均为目标设计。

面向管理层 ​

  1. 阅读平台价值,了解平台定位、企业问题和预期收益。
  2. 阅读企业价值与应用场景,选择首个可量化场景。
  3. 阅读建设路线与管理决策,明确业务所有者、投入边界和验收指标。

第一次了解平台 ​

  1. 阅读项目概览,确认平台定位、边界和当前状态。
  2. 从技术架构进入七层逻辑架构和服务架构,分别理解能力分层与九个服务边界。
  3. 阅读端到端流程,理解查询、审批回写和证据关联。

准备参与研发 ​

  1. 阅读技术选型和项目结构。
  2. 按负责领域进入服务架构,确认服务拥有的数据、接口和明确不承担的职责。
  3. 阅读契约与事件,再修改 contracts/ 中的机器可读定义。
  4. 按实施路线与验收确定当前阶段和完成标准。
  5. 用分阶段开发任务清单分配工作包;用开源项目选型与接入成本评估候选组件。

准备接入平台 ​

准备部署和运维 ​

内容权威性 ​

内容权威来源
产品、架构、接入和运维说明docs/
REST、事件、Schema、MCP 定义contracts/
服务实现细节对应 services/* 源码和 README
共享接口与生成类型packages/*
架构决策及取舍docs/adr/

当文档与机器可读契约冲突时,以已发布的契约版本为准,并修正文档;当文档与运行行为冲突时,以可复现的运行证据为准,并将差异作为缺陷处理。