lumina: Skill for Claude Code

Lumina 简化分层架构规范

功能概述

本技能包用于确保 Lumina 框架项目遵循简化分层架构，包括层次划分、职责定义、依赖关系等。

标准分层结构

lumina-modules/
└── lumina-{domain}/
    └── src/main/java/io/lumina/
        └── {domain}/
            ├── api/                    # 接口层 (API Layer)
            │   ├── controller/         # REST 控制器
            │   └── dto/                # 数据传输对象 (Request/Response)
            │
            ├── service/                 # 业务服务层 (Service Layer) - 核心
            │   ├── {业务}Service.java  # 业务服务接口
            │   └── impl/                # 业务服务实现
            │
            ├── domain/                 # 领域模型层 (Domain Layer)
            │   ├── model/               # 领域实体（包含业务方法）
            │   └── enums/               # 领域枚举
            │   │
            │   # 以下为可选（根据业务复杂度决定是否使用）
            │   ├── valueobject/        # 值对象（复杂场景使用）
            │   ├── event/              # 领域事件（如需要事件驱动）
            │   └── repository/         # 仓储接口（如需要抽象持久化）
            │
            └── infrastructure/          # 基础设施层 (Infrastructure Layer)
                ├── mapper/              # MyBatis Mapper
                ├── entity/              # 数据库实体 (DO - Data Object)
                └── converter/           # DO <-> Domain 转换器（可选）
                │
                # 以下为可选
                ├── external/            # 外部服务调用
                └── config/              # 配置类

层次职责说明

API 层 (接口层)

• 职责: 处理 HTTP 请求/响应，参数校验，权限控制
• 包含: Controller、DTO (Request/Response)
• 规则:
  • Controller 只负责接收请求、调用 Service、返回响应
  • 不包含业务逻辑
  • 使用 DTO 进行数据传输

Service 层 (业务服务层) - 核心

• 职责: 业务逻辑处理，事务管理，业务流程编排
• 包含: Service 接口和实现
• 规则:
  • 包含应用服务逻辑（编排、事务）
  • 包含领域服务逻辑（复杂业务规则）
  • 调用 Domain 模型的方法
  • 调用 Infrastructure 的 Mapper
  • 负责 DTO 与 Domain 对象的转换

Domain 层 (领域模型层)

• 职责: 领域实体和业务规则
• 包含: Entity、枚举
• 可选: Value Object、Domain Event、Repository 接口（根据业务复杂度决定）
• 规则:
  • Entity 包含业务方法和业务规则
  • 不依赖其他层（保持领域模型的纯净）
  • 简单场景: 直接使用基本类型（String、Long 等）
  • 复杂场景: 使用 Value Object 封装业务规则
  • Repository 接口可选，简单场景直接使用 Mapper