aomin/hepu

0 Fork 0

Files

T

aomin a7605ef8b8 chore(repo): 导入 M-Z 业务底座 V1.9 基线并建立仓库规范

按周工交付的 SEC-Z-01 清理后源码建立 M-Z 主干，并按 Git 仓库惯例重排目录。

- aomin-gateway/  后端工程 87 文件，原样保留，路径与构建命令未变
- demo/           演示前端与设备模拟器 9 文件（原 02_前端与设备端），非正式三端
- docs/handover/  交付与安全清理材料 6 份，内容未改
- docs/contract/  J-00 规格、OpenAPI、内部五接口、状态机、Mock 样例
- docs/reference/ 指纹与校验清单，含 84 个源码文件的 sha256 清单

目录重排只动位置不动内容：源码树 84 文件哈希与交付一致，逐文件自校验通过；
12 条 Flyway 迁移与交付包内镜像逐字节一致。

未纳入：迁移镜像目录（与工程内一套重复，改留指纹）、target/、证据 raw、
应急恢复脚本、评审用虚构台账数据。

安全：SEC-Z-01 15 处明文已清零，导入前重新扫描无新增命中，本仓库无历史污染。
行尾按交付字节原样保存（.gitattributes 设 * -text），不做归一化以免整树摘要失效。

2026-11-13 17:32:37 +08:00

4.2 KiB

Raw Blame History

变更记录

本文件记录仓库层面的变更（目录结构、契约版本、迁移序列、安全处置）。代码内部改动以提交历史为准，不在此重复登记。

版本号与 docs/handover/03_Z-02_清理后哈希与构建说明.md 第五节的「版本标识一致性」保持一致。

[V1.9-baseline] - 2026-11-13

首次入库，对应周工交付的 SEC-Z-01 清理后 源码包。

Added

aomin-gateway/：M-Z 业务层完整 Maven 工程 87 文件，含 84 个 src/main 文件、pom.xml、README.md、start-gateway.bat。
demo/：演示前端与设备模拟器 9 文件（web/ 静态页 7 个、sim/sim_device.py、README.md）。不是正式三端。
docs/handover/：交付与安全清理材料 6 份（00 包说明、01 差异清单、02 扫描报告、03 哈希与构建、04 证据边界、gitignore_建议）。
docs/contract/：接口契约 6 份，含 J-00 接入接口规格（md + OpenAPI yaml）、OpenAPI 使用说明、内部五接口定义、状态机、Mock 样例。
docs/reference/：原始交付包指纹说明，以及两个原始 SHA256SUMS 清单、12 条迁移脚本哈希。
docs/reference/SHA256SUMS_源码树.txt：84 个源码文件的逐文件哈希，sha256sum -c 可直接校验（导入时自校验 84/84 通过）。交付方给的整树摘要 5E9F894B… 算法描述不足复现，此清单纯为替代物。
仓库级规范文件：README.md、LICENSE、CHANGELOG.md、CONTRIBUTING.md、SECURITY.md、.gitignore、.gitattributes、.editorconfig。

Changed

目录重排，便于跨平台工具与外部读取：
- 02_前端与设备端/ → demo/（web/、sim/ 子路径不变，demo/README.md 原文未改）
- 04_OpenAPI与内部IoT契约/ → docs/contract/
- 00～04 五份交接件与 gitignore_建议.txt → docs/handover/
- 两个 SHA256SUMS_包内.txt → docs/reference/，重命名以区分作用域
原包根目录的 README.md（本为后端工程说明）保留为 aomin-gateway/README.md，仓库根改为项目总览。文件内容未改。

Excluded

03_数据库与Flyway迁移/：与 aomin-gateway/src/main/resources/db/migration/ 是同一套 12 条的两次出现。仓库只保留工程内一套，避免两处漂移；镜像与工程内副本已核为逐字节一致，指纹见 docs/reference/原始交付包指纹.md。
target/、*.jar：构建产物。
证据原始数据（raw/、日志、截图）：按受控目录单独交付。
99_应急恢复（非正式路径）：应急手段，非主干迁移序列。
评审用虚构台账数据：演示数据。

Security

按 SEC-Z-01 清理后入库：15 处明文口令 → 0 处，扫描 0 命中，.git 无历史污染（本仓库为首次提交，交付包内无 .git）。
目录重建时已重新扫描一次硬编码凭据，未新增命中；application.yml 的口令仅从 ${DB_PASS} 取，无默认值。
口令未轮换，登记为待确认项，判据见 docs/handover/02_SEC-Z-01_敏感信息扫描报告.md 第四节。

Known Issues

以下问题在交付包中即存在，本次整理未修改代码（改动会变更受控哈希，需走会签）：

src/main/resources/application.yml 注释残留"本地库已有 83 表""从 V1.0.1 起递增"，实际为 87 表、终态 1.0.28；baseline-description 仍是 baseline-83-tables。
config/GatewayProperties.java 的 auth.enabled 默认 false，共享密钥默认占位值 change-me-in-production；上线前必须注入真实值并打开，否则 /internal/** 只靠网络闸防护。
工程内无 src/test，无单元测试；验证依赖 155 条外部证据脚本（未随仓库交付）。
03_Z-02 给的源码树摘要 5E9F894B… 无法用文中描述的算法复现（缺分隔符、大小写、路径前缀规则），已试 60 余种组合。只能作标识引用，不作校验凭据。
交付包行尾不统一（14 个文件 CRLF、其余 LF），未归一化——归一化会改变整树字节，使摘要复核失效；.gitattributes 设为 * -text 原样保存。
A-Z-01／02／03 未关闭；并发 PULL 与真机未覆盖。

4.2 KiB Raw Blame History Unescape Escape