新增应用与工程规范

确定产品边界

新增产品先确定业务域、产品代码、职责与集成契约。检查官网产品目录与已有应用，避免把同一领域拆成重复系统。DMS 是渠道管理，EDMS 是文档管理。

标准结构

products/<domain>/<product>/
├── product.yaml
├── web/
├── services/
├── contracts/
├── database/
├── tests/
├── deploy/
└── docs/

一个产品可按规模拥有多个服务，但不为形式强制拆分微服务。每个可部署单元必须能独立构建、发布与回滚。

接入步骤

1. 建立前端 workspace；根 npm 已包含 products/*/*/web。
2. 为 API 建立独立 Maven 模块与数据库所有权，并维护 Flyway 迁移。
3. 分配并登记本地端口；Web 设置严格端口模式。
4. 注册 OAuth 客户端、应用标识、权限与必要服务 scopes。
5. 添加 Gateway 路由，接入IAM 鉴权。
6. 在 contracts 维护 API 与事件的版本，定义幂等和失败处理。
7. 在官网与文档中心登记应用名称、当前边界及用户操作指南。

生成器边界

仓库生成器只覆盖带 .edma-scaffold 标记的产品。开始定制开发后，按现有生成器约定退出覆盖范围；不要用 scaffold 覆盖手工业务实现。

前后端职责

Web 负责显示、输入和交互；后端负责租户、动作、数据范围、对象状态与事务。共享前端组件可以复用传输契约，不共享跨产品 DAO 或领域实体。

验证与交付

单独构建目标 workspace 与 Maven 模块，验证迁移和关键业务路径。功能交付同步补齐文档、适用版本、截图和接口变化，不把根全量构建作为每次产品发布的强制依赖。

API 索引 · 部署与回滚