交付与治理
记录该项目实际执行的交付与治理做法,包括没有做到位的部分。不披露客户与团队身份信息。
1. 项目章程
| 项 | 内容 |
|---|---|
| 目标 | 先建平台底座,再按业务边界上线各域系统 |
| 范围 | 平台服务、IT 平台、企业职能、企业业务;计费与财务参考系统只保留接入位置 |
| 角色 | 方案与架构、后端、前端、测试、运维,小团队多角色兼任 |
| 节奏 | 平台先行 → 单域闭环 → 多域铺开 |
| 主要风险 | 平台成为关键路径、单节点可用性、跨域事务复杂度、端口规划越界 |
2. 研发规范
- 接口先行:接口定义先落到接口文档,前后端按契约并行开发,联调以文档为准。
- 服务模板:新服务从统一骨架起步,依赖版本、配置结构、日志格式保持一致。
- 边界约束:一服务一库、数据库按
svc_<domain>命名、端口按服务类型分段。 - 评审:合并前评审;涉及公共能力下沉到平台层的改动,需要架构侧确认。
- 依赖管理:统一使用制品库,版本收敛,避免同类组件多版本并存。
3. 测试
- 接口测试为主,覆盖各服务对外契约;
- 关键业务链路做回归,跨域流程按端到端验证;
- 前端按业务域验收,联调以接口文档为基准;
- 已知缺口:自动化测试与性能测试覆盖不足,关键链路仍依赖手工回归,已作为技术债登记。
4. 运维
- 部署:Docker 单节点,按基础服务、平台服务、业务服务、Web 服务四组划分部署单元,Nginx 统一托管前端;
- 观测:统一日志格式与健康检查,监控告警优先保障平台服务;
- 数据:数据库定期备份,恢复演练尚未常态化;
- 变更:部署脚本化,减少手工步骤与记忆成本。
5. 技术债与安全治理
技术债登记
| 项 | 表现 | 影响 | 处理方向 |
|---|---|---|---|
| 端口规划越界 | 少量服务超出分段 | 部署与排查成本上升 | 收敛端口规划 |
| 自动化测试不足 | 关键链路依赖手工回归 | 回归效率低、发布信心不足 | 补接口自动化,先覆盖主链路 |
| 监控覆盖不均 | 业务域指标偏少 | 故障定位慢 | 统一接入平台监控 |
| 前端复用不足 | 各域 Web 各自实现 | 交互与视觉不一致 | 抽公共组件 |
| 文档与实现不同步 | 接口文档依赖人工维护 | 联调成本上升 | 契约先行、文档随代码更新 |
安全治理
- 鉴权集中在网关与授权服务,业务域不各自实现登录与权限;
- 权限按菜单、接口、数据三层控制,遵循最小权限;
- 凭据不进入代码库,环境配置与代码分离;
- 数据备份是底线要求;
- 已知缺口:审计日志与密钥轮换尚未体系化。
6. 复盘
做对了:平台先行避免了重复实现;一服务一库让边界在代码与数据上都成立;接口先行支撑了前后端并行;单节点起步把成本压在了可承受范围。
代价:单节点可用性有限,平台服务是关键路径;测试与监控滞后于功能交付;端口规划出现过越界。
下一步:按域扩容、补主链路自动化、监控统一接入、报表与数仓独立成层、端口规划收敛。