docs(requirements): 清理废话——复述标题、自相矛盾、笼统归属
- 开头合并去重,删同义反复和"以本文件为准"式声明 - 非目标段删实现层否定、旧系统背景、法律腔 - US-06/11/14 目标删复述,留动机或目的 - US-13 标准 5 整条删(与 §1 数据面段重复三处)
This commit is contained in:
+10
-15
@@ -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 航班历史与清理
|
||||
|
||||
**目标**:已结束运营的航班转入历史存储供历史查询使用,并从实时数据中删除,保持实时数据精简。
|
||||
**目标**:保持实时数据精简。
|
||||
|
||||
**验收标准**
|
||||
|
||||
|
||||
Reference in New Issue
Block a user