mirror of
https://github.com/hpd840321/starRiverProperty.git
synced 2026-06-09 16:30:29 +08:00
e8672a3c7b
Former-commit-id: dc30d42a8c55ed8b2382a41dc2434233fbed9930
3.6 KiB
3.6 KiB
maven-cw-elevator-application/ — 电梯应用
OVERVIEW
CloudWalk 电梯管理系统主应用。Spring Boot 2.x + Spring Cloud(Feign/Consul/Ribbon),五模块聚合工程,当前迭代唯一主力目标。
STRUCTURE
maven-cw-elevator-application/
├── AGENTS.md # ← 本文件
├── pom.xml # 聚合父 POM(JDK 8、formatter、enforcer)
├── .gitignore # 排除 releases/*.jar 与 .m2-elevator-nexus-only/
├── deploy/ # 部署配置
├── tools/ # 辅助工具
│ ├── elevator_api_parity/ # pytest API 对拍测试(V1 vs V2)
│ │ ├── tests/
│ │ │ ├── test_parity_full_catalog.py
│ │ │ ├── test_smoke_catalog.py
│ │ │ ├── test_parity_endpoints.py
│ │ │ └── test_unit_compare.py
│ │ ├── conftest.py
│ │ └── requirements.txt # Python 3.8+
│ └── v1-decompiled/ # CFR 反编译输出(只读)
├── cw-elevator-application-common/ # 公共工具与常量
├── cw-elevator-application-data/ # 数据层(DAO/Entity/Repository)
├── cw-elevator-application-service/ # 业务服务层
├── cw-elevator-application-web/ # Web 控制器层
└── cw-elevator-application-starter/ # 启动模块
└── src/main/java/.../ElevatorApplication.java # @SpringBootApplication
WHERE TO LOOK
| Task | Location | Notes |
|---|---|---|
| 启动入口 | cw-elevator-application-starter/.../ElevatorApplication.java |
Spring Boot 主类 |
| Feign 客户端 | cw-elevator-application-web/ |
对外 HTTP 接口 |
| 业务逻辑 | cw-elevator-application-service/ |
Service 层实现 |
| 数据访问 | cw-elevator-application-data/ |
DAO + Entity |
| 公共工具 | cw-elevator-application-common/ |
常量、工具类 |
| 部署配置 | deploy/ |
Consul、Ribbon 等配置 |
| API 对拍 | tools/elevator_api_parity/tests/ |
pytest 双端对比 |
| V1 参考 | tools/v1-decompiled/ |
V1 CFR 反编译(只读) |
CONVENTIONS
- JDK 8,
java.version=1.8(pom.xml 第 29 行) - P3C Eclipse Formatter 2.16.0(
formatter-maven-plugin) maven-enforcer-plugin强制 JDK 8jacoco-maven-plugin代码覆盖率(starter POM)- 模块依赖链:web → service → data → common
- 对外 HTTP/Feign 接口不可扩展(当前迭代约束)
COMMANDS
# 构建(跳过测试)
mvn clean install -DskipTests
# 格式化校验
mvn formatter:validate -Dformatter-maven-plugin.version=2.16.0
# API 对拍测试
cd tools/elevator_api_parity && pip install -r requirements.txt && pytest tests/
# 跑全部对拍
bash scripts/run_full_elevator_api_suite.sh
NOTES
- V1 运行包参考:
cw-elevator-application-V1.0.0.20211103/lib/(仓库根目录) - 当前分支目标:V1 lib 对齐(最小风险),Consul/Ribbon 固定配置
- 前端电梯管理页面无可用源码,相关任务本阶段跳过