Files
hpd840321 7b2bd307f1 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.
2026-05-09 09:56:45 +08:00

3.6 KiB
Raw Permalink Blame History

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 8java.version=1.8pom.xml 第 29 行)
  • P3C Eclipse Formatter 2.16.0formatter-maven-plugin
  • maven-enforcer-plugin 强制 JDK 8
  • jacoco-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 固定配置
  • 前端电梯管理页面无可用源码,相关任务本阶段跳过