05 项目分层架构与编码规范

目标

建立一套清晰的代码分层标准，保证项目的可维护性和可扩展性。

标准分层

fin-flow-account/
├── src/main/java/com/finflow/account/
│   ├── controller/          # HTTP 入口层
│   ├── service/             # 业务逻辑层
│   ├── repository/          # 数据持久化层
│   ├── domain/              # 领域模型 (DDD)
│   ├── dto/                 # 数据传输对象
│   ├── exception/           # 自定义异常
│   ├── config/              # 配置类
│   └── util/                # 工具类
├── src/main/resources/
│   ├── application.yml
│   └── db/migration/        # Flyway 脚本
└── pom.xml

各层职责

🌐 Controller 层

• HTTP 请求入口
• 参数校验
• 调用 Service

💼 Service 层

• 业务逻辑处理
• 事务管理
• 跨模块编排

📦 Repository 层

• 数据库 CRUD
• 查询构建
• 缓存策略

🎯 Domain 层

• 核心业务实体
• 值对象
• 业务规则

编码规范

规范项	标准
包名	com.finflow.{service}.
类名	PascalCase，sufx: Controller/Service/Repo
方法名	camelCase，动词开头: get/find/save/update
常量	UPPER_SNAKE_CASE
变量	camelCase

异常处理统一模式

所有异常继承 BaseException，统一由全局异常处理器处理...

下一阶段

→ 06 基础服务