# 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 固定配置
- 前端电梯管理页面无可用源码，相关任务本阶段跳过