73 lines
2.8 KiB
Markdown
73 lines
2.8 KiB
Markdown
当前架构
|
||
|
||
已从 开发 -> FTP -> 生产 改为 生产环境单 prod-agent -> 开发 Git / 生产 push-pull API
|
||
正式启动类是 GitDirectSyncToolApplication.java
|
||
已完成
|
||
|
||
Git -> PROD 主链路已可用
|
||
PROD -> Git 主链路已可用
|
||
生产真实接口已按 testapi.txt 适配
|
||
pushConfig：POST + JSON数组
|
||
pullConfig：GET + JSON响应
|
||
login：已支持 token 获取与缓存
|
||
ackSuc/ackFail：已接入回传与本地落库
|
||
ConfigCryptoService：已抽出，当前默认透传实现，后续只需替换该服务内算法
|
||
Git -> PROD：已支持最小增量推送，删除场景自动回退全量
|
||
Git -> PROD：已改为先按 git.repo.scan-branch-pattern 批量扫描版本分支，再逐个按“版本分支 + 机场目录 + 模块目录”解析参数
|
||
PROD -> Git：已按 airportId/appName/fileName 目录结构回写到动态 snapshot 分支
|
||
Git -> PROD：sourceVersion/configVersion 已改为 Git 分支名，不再用 commit SHA
|
||
Git -> PROD：baseline 已按版本分支隔离
|
||
pullConfig：已支持 configVersion/fileName 可选过滤参数
|
||
ackFail：已支持按 airportId/appName/configVersion/fileName 定向重拉
|
||
ackFail：失败记录已增加 retryCount/nextRetryAt/lastErrorMsg 元数据
|
||
管理接口已加：
|
||
GET /api/admin/sync/overview
|
||
GET /api/admin/sync/tasks/recent
|
||
GET /api/admin/sync/tasks/failed
|
||
docs 下设计文档和接口文档已同步更新到当前口径
|
||
|
||
Git 仓库约定
|
||
|
||
Git -> PROD：
|
||
- 支持两种入口：
|
||
- git.repo.scan-branch：只同步一个指定版本分支
|
||
- git.repo.scan-branch-pattern：批量扫描所有匹配分支，当前默认用于 R_XXX_.*
|
||
- 分支名本身就是 configVersion
|
||
- 分支内目录结构必须为：airportId/appName/模块内文件
|
||
- pushConfig 参数映射：
|
||
- airportId = 路径第1段
|
||
- appName = 路径第2段
|
||
- fileName = 模块内相对路径
|
||
- configVersion = 当前分支名
|
||
|
||
PROD -> Git：
|
||
- pullConfig 返回项会恢复为：airportId/appName/fileName
|
||
- 当前提交目标分支为：git.repo.snapshot-branch/<configVersion>
|
||
- 例如：config-prod-snapshot/R_XXX_V3.0.3_XXX
|
||
- 若 pullConfig 返回缺少统一版本号，则按当前 result 的 sourceVersion 退化生成动态分支名
|
||
|
||
关键文件
|
||
|
||
生产接口适配：ProdConfigApiService.java
|
||
加解密扩展点：ConfigCryptoService.java
|
||
主协调器：ProdSyncCoordinator.java
|
||
ACK 落库：
|
||
ProdPullAckRecord.java
|
||
ProdPullAckService.java
|
||
管理接口：SyncManagementController.java
|
||
接口文档：prod-api-v1.md
|
||
设计文档：
|
||
git-direct-sync-tool-design.md
|
||
ftp-sync-tool-design.md
|
||
ftp-sync-tool-detail-design.md
|
||
当前 TODO
|
||
|
||
configContent 推送前加密
|
||
configContent 拉取后解密
|
||
验证状态
|
||
|
||
mvn -s build-support/maven-settings.xml test 已通过
|
||
如果你是想让我继续下一步，最顺的就是：
|
||
|
||
把 ConfigCryptoService 的透传实现替换为正式加解密算法
|