mirror of
https://github.com/hpd840321/starRiverProperty.git
synced 2026-06-10 00:40:30 +08:00
hpd840321
7b2bd307f1
- backend/: 13 Maven modules (cw-elevator-application, cloudwalk-cloud, intelligent-cwoscomponent, ninca-crk, etc.) - frontend/: 4 Vue projects (elevator-front, cwos-portal, alarm-front, front_acs) + decompiled + scripts - scripts/: build, test-env, tools (Docker Compose, service templates, API parity) - docs/: AGENTS.md, superpowers specs, architecture docs - .gitignore: standard Java/Maven exclusions Moved from legacy maven-*/ root layout to backend/ organized structure.
79 lines
3.6 KiB
Markdown
79 lines
3.6 KiB
Markdown
# 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 8
|
||
- `jacoco-maven-plugin` 代码覆盖率（starter POM）
|
||
- 模块依赖链：web → service → data → common
|
||
- 对外 HTTP/Feign 接口**不可扩展**（当前迭代约束）
|
||
|
||
## COMMANDS
|
||
|
||
```bash
|
||
# 构建（跳过测试）
|
||
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 固定配置
|
||
- 前端电梯管理页面无可用源码，相关任务本阶段跳过
|
||
|