mirror of
https://github.com/hpd840321/starRiverProperty.git
synced 2026-06-09 08:20:31 +08:00
docs: record v2.0.17 as baseline, update service discovery doc
- Mark v2.0.17 as current production baseline in AGENTS.md - Update service discovery architecture design doc: add §6-10 for actual implementation state, preserve original as history (§1-5) - Document key decisions: no ZK discovery, ConfigurationBasedServerList, bootstrap aligned with V1
This commit is contained in:
+37
-3
@@ -3,6 +3,8 @@
|
||||
## OVERVIEW
|
||||
starRiverProperty 全仓文档集中地:架构说明、业务走查、构建环境、代码风格、运维脚本。原 `dev-support/` 内容已迁入此处。
|
||||
|
||||
**当前基线版本:v2.0.17**(2026-05-05 生产验证通过)
|
||||
|
||||
## STRUCTURE
|
||||
```
|
||||
docs/
|
||||
@@ -19,21 +21,52 @@ docs/
|
||||
│ └── ORIGINAL_BUILD_JDK.txt # JDK 8 依据
|
||||
├── style/ # 代码风格
|
||||
│ └── alibaba-eclipse-codestyle.xml # P3C Eclipse Formatter
|
||||
└── operations/ # 运维脚本
|
||||
└── deploy_cw_elevator_v1_lib_to_nexus.py # V1 lib → Nexus
|
||||
├── operations/ # 运维脚本
|
||||
│ └── deploy_cw_elevator_v1_lib_to_nexus.py # V1 lib → Nexus
|
||||
├── superpowers/
|
||||
│ ├── specs/ # 设计规格文档
|
||||
│ └── data/ # 分析记录与调查报告
|
||||
└── sql/ # 数据库 DDL 与初始化脚本
|
||||
```
|
||||
|
||||
## WHERE TO LOOK
|
||||
|
||||
| Task | Location | Notes |
|
||||
|------|----------|-------|
|
||||
| 当前迭代排期 | `README.md` | 前端跳过、后端优先的迭代范围 |
|
||||
| 当前基线版本 | `AGENTS.md` | v2.0.17(2026-05-05) |
|
||||
| 聚合工程关系 | `architecture/Maven聚合工程说明.md` | 模块依赖与工程定位 |
|
||||
| 接口契约约束 | `architecture/对外接口不变-远程调用与性能优化约定.md` | 不可扩展的 HTTP/Feign 边界 |
|
||||
| 走查任务清单 | `architecture/对外接口不变-走查任务与状态.md` | 可修正与须确认项 |
|
||||
| 代码风格配置 | `style/alibaba-eclipse-codestyle.xml` | P3C 格式化 XML |
|
||||
| JDK 版本依据 | `build/ORIGINAL_BUILD_JDK.txt` | JDK 8 强制依据 |
|
||||
| Nexus 上传 | `operations/deploy_cw_elevator_v1_lib_to_nexus.py` | V1 lib 批量部署 |
|
||||
| 服务发现架构 | `superpowers/specs/2026-05-01-service-discovery-architecture-design.md` | 设计文档(实施态) |
|
||||
| ConsulServerList 分析 | `superpowers/data/2026-05-05-consulserverlist-static-ip-discovery-analysis.md` | V1 vs V2 服务发现差异调查 |
|
||||
|
||||
## 基线版本信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
|------|------|
|
||||
| **版本** | **v2.0.17** |
|
||||
| **状态** | ✅ 生产环境验证通过 |
|
||||
| **验证日期** | 2026-05-05 |
|
||||
| **JAR 文件名** | `cw-elevator-application-V1.0.0.20211103.jar`(与 V1 一致) |
|
||||
| **主类** | `cn.cloudwalk.elevator.AppApplication`(与 V1 一致) |
|
||||
| **Spring Boot** | 2.1.18.RELEASE |
|
||||
| **Spring Cloud** | Greenwich.SR6 |
|
||||
| **JDK** | 1.8(强制) |
|
||||
| **Git rev** | `1c5e60f6` |
|
||||
| **配置基线** | `deploy/v2-maven/bootstrap.properties` 与 V1 生产完全一致 |
|
||||
|
||||
### 关键决策记录
|
||||
|
||||
| 决策 | 选择 | 原因 |
|
||||
|------|------|------|
|
||||
| 服务发现 | `discovery.enabled=false` + ConfigurationBasedServerList | 与 V1 生产一致;ZK 发现依赖已移除 |
|
||||
| Feign 注解 | OpenFeign(org.springframework.cloud.openfeign.FeignClient) | V1 使用 Netflix Feign,V2 已迁移 |
|
||||
| 主类名 | AppApplication(与 V1 一致) | 对齐 V1 命名 |
|
||||
| JAR 文件名 | cw-elevator-application-V1.0.0.20211103.jar(固定) | 生产部署习惯,与 V1 一致 |
|
||||
| 租户策略 | 新增 tenant_visitor_floor_policy 表 | 新功能,仅在配置策略后生效 |
|
||||
|
||||
## CONVENTIONS
|
||||
|
||||
@@ -41,3 +74,4 @@ docs/
|
||||
- `docs/` 是文档唯一定位点,`dev-support/` 已废弃
|
||||
- 格式化 XML 路径:所有 `maven-*/pom.xml` 的 `alibaba.eclipse.codestyle.path` 均指向 `docs/style/`
|
||||
- 运行 JAR 还原产物不在 `docs/`,而在 `artifacts/decompiled/`
|
||||
- **后续所有开发以 v2.0.17 为基线**,在此版本基础上修改和完善
|
||||
|
||||
Reference in New Issue
Block a user