docs(requirements): 清理废话——复述标题、自相矛盾、笼统归属

- 开头合并去重,删同义反复和"以本文件为准"式声明
- 非目标段删实现层否定、旧系统背景、法律腔
- US-06/11/14 目标删复述,留动机或目的
- US-13 标准 5 整条删(与 §1 数据面段重复三处)
This commit is contained in:
windyboy
2026-09-20 07:48:10 +08:00
parent 2bd650a551
commit aef7b00104
+10 -15
View File
@@ -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 航班历史与清理
**目标**已结束运营的航班转入历史存储供历史查询使用,并从实时数据中删除,保持实时数据精简。
**目标**:保持实时数据精简。
**验收标准**