diff --git a/docs/requirements.md b/docs/requirements.md index 8aaab28..887fcc9 100644 --- a/docs/requirements.md +++ b/docs/requirements.md @@ -1,28 +1,24 @@ # 需求与验收目标 -本文件定义交付范围、非目标与验收口径：**需求定义要交付什么，验收标准定义怎样证明完成**。以下事实以本文件为唯一出处： - -- `US-01`～`US-14`（三级标题定义）、`OPS-1`～`OPS-4`（注册表定义）。 - -本文件只写交付范围与验收口径，不重复代码入口、参数取值和实现机制。 +本文件定义交付范围、非目标与验收口径。 ## 1. 范围与非目标 -**系统定位**：OMMS H5 查询系统的消息网关。收取 CIIMS adapter 信箱中 AODB 下发的 XML 报文：航班动态写入数据库并同步写 Redis，运营航班的动态消息经 Kafka 发给运营航班显示界面实现同步；静态参考数据写入数据库，供 admin-api 只读。出站仅向 AODB 发参考数据类请求和日计划请求（经 `COUTMSGS`，消费方为 CIIMS adapter）。 +**系统定位**：OMMS H5 查询系统的消息网关。收取 CIIMS adapter 信箱中 AODB 下发的 XML 报文：航班动态写入数据库并同步写 Redis，运营航班的动态消息经 Kafka 发给运营航班显示界面；静态参考数据写入数据库，供 admin-api 只读。出站仅向 AODB 发参考数据类请求和日计划请求（经 `COUTMSGS`，消费方为 CIIMS adapter）。 **交付范围**：`US-01`～`US-14`、`OPS-1`～`OPS-4`。 **非目标**： -- 航班当前态权威只在自有 PG；Redis 仅作查询投影，不作权威或处理状态。不引入并行主泵或分布式锁。 +- 航班当前态权威只在自有 PG；Redis 仅作查询投影，不作权威或处理状态。 - 共享 MySQL 只做读写消息和写回处理标记，不改表结构、不建表；已回填的入站行超过保留期后由本系统清理（specification.md 的 `C-1`）。 -- 本消息网关只有一个实例，暂不考虑多实例运行方案。 +- 本消息网关只有一个实例。 - 对外投递只承诺至少一次；同一航班（`FLID`）内保序，不同航班之间不承诺顺序。 -- 测试环境用 PostgreSQL；生产环境尚未决定用 PostgreSQL 还是 Oracle 11g，Oracle 适配验证通过前不构成支持承诺。 +- 测试环境用 PostgreSQL；生产环境尚未决定用 PostgreSQL 还是 Oracle 11g。 - 已结束的航班写入 Elasticsearch 历史库后从实时数据删除。 -- 不生成航班/业务数据类报文，不替代 CIIMS/AODB，不提供 AODB 主数据编辑能力。 +- 不生成航班/业务数据类报文，不提供 AODB 主数据编辑能力。 - 不调用 admin-api，不从 admin-api 拉取、补全或合并任何数据。 -- 不在 Redis 缓存机位基础数据与登机桥映射：旧系统的 `orms_stand`、`orms_stand_airbridge` 靠调用 admin-api 填充，本版不交付（`C-10`）。 +- 不在 Redis 缓存机位基础数据与登机桥映射，本版不交付（`C-10`）。 **查询侧（admin-api）的数据面**：admin-api 是只读数据层，不生产航班动态，也不保存实时航班；它的季度计划与基础数据都从本系统的数据库读，其中季度计划的供数方待定（specification.md 的 `Q25`）。基础数据的数据集为： @@ -91,7 +87,7 @@ ### US-06 删除航班（FDEL） -**目标**：按 AODB 指令删除航班；共享航班与主航班联动删除，不允许删了一半。 +**目标**：按 AODB 指令删除航班。 **验收标准** @@ -146,7 +142,7 @@ ### US-11 处理记录清理 -**目标**：处理记录只用于追踪消息处理情况和排查问题，没有长期保留价值；定期删掉老记录，防止表无限增长。 +**目标**：处理记录只用于追踪消息处理情况和排查问题，没有长期保留价值。 **验收标准** @@ -173,11 +169,10 @@ 2. 一类数据校验不通过就不更新这一类，其他类照常；已有数据不动。 3. 全量消息整体替换，增删改消息逐条处理。 4. 消息里字段为空表示「当前没有值」，不是删除。 -5. 参考数据保存在独立的数据表中，查询系统（admin-api）直接读取。 ### US-14 航班历史与清理 -**目标**：已结束运营的航班转入历史存储供历史查询使用，并从实时数据中删除，保持实时数据精简。 +**目标**：保持实时数据精简。 **验收标准**