开发规范

1. 总体技术栈

1.1 后端

语言版本：Java 17
构建工具：Gradle Wrapper
框架版本：Spring Boot 2.7.9
核心能力：Spring Web、Spring Data JPA、Spring Security、Actuator
数据库：PostgreSQL
数据迁移：Flyway
工作流：Camunda 7.16.0
测试体系：JUnit 5、AssertJ、Mockito、Hamcrest、Testcontainers、Spring REST Docs
代码质量：Checkstyle、JaCoCo

1.2 管理端前端

路径：frontends/xxx.webui
技术栈：Vue 3 + TypeScript + Vite
UI 组件库：Element Plus
包管理器：Yarn 1.22.22
测试工具：Vitest

1.3 小程序前端

路径：frontends/miniprogram-webui
技术栈：uni-app + Vue 3 + TypeScript + Pinia
UI 组件库：wot-design-uni
包管理器：pnpm 10
运行要求：package.json 明确要求 Node.js >= 20、pnpm >= 9

工程结构规范

2.1 后端分层约束

后端采用“多模块单体 + 明确分层”结构，核心分层规则如下：

frameworks.* 基础框架能力，不承载具体业务语义
*.core 领域通用核心对象与接口，供本业务域或其他域复用
*.domain 领域模型、聚合、仓储接口、领域服务、领域规则
*.application 用例编排层，对外提供 Use Case，不直接承载基础设施实现
*.gateways 对外接口层与基础设施适配层，包括 Controller、JPA、ACL、配置类

2.1 依赖方向要求

新增代码必须遵守以下依赖方向：
gateways -> application -> domain -> core -> frameworks
gateways 可以依赖持久化、Web、安全、第三方系统适配
application 只做用例编排，不直接落地数据库细节
domain 不应依赖 Web Controller、JPA Entity、HTTP 细节
根启动工程只做装配，不承载业务实现

禁止出现以下情况：
domain 反向依赖 gateways
application 直接编写 Controller 或 JPA Entity
不经模块边界直接在根工程堆积业务代码