Initial commit: reorganized source tree

- 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.
This commit is contained in:
hpd840321
2026-05-09 09:00:12 +08:00
commit 7b2bd307f1
7260 changed files with 612980 additions and 0 deletions
+78
View File
@@ -0,0 +1,78 @@
# maven-cw-elevator-application/ — 电梯应用
## OVERVIEW
CloudWalk 电梯管理系统主应用。Spring Boot 2.x + Spring CloudFeign/Consul/Ribbon),五模块聚合工程,当前迭代唯一主力目标。
## STRUCTURE
```
maven-cw-elevator-application/
├── AGENTS.md # ← 本文件
├── pom.xml # 聚合父 POMJDK 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 固定配置
- 前端电梯管理页面无可用源码,相关任务本阶段跳过