技能管理系统中的目录结构优化：从混乱到可维护的架构演进

4次阅读

没有评论

共计 2366 个字符，预计需要花费 6 分钟才能阅读完成。

在开发技能管理系统时，糟糕的目录结构往往会引发一系列问题，严重影响开发效率和系统可维护性。以下是我在实践中总结的常见痛点：

功能高度耦合 ：业务逻辑散落在各处，修改一处可能影响多个功能
代码查找困难 ：相关功能的代码分散在不同目录，增加开发认知负担
团队协作障碍 ：缺乏统一规范导致每个人按自己习惯组织代码
测试困难 ：业务逻辑与框架代码混杂，难以编写单元测试
扩展性差 ：添加新功能时不知该放在哪里，随意放置加剧混乱

业务逻辑容易渗透到 Controller 层
Model 层容易变成 ” 上帝对象 ”
随着功能增加，各层会不断膨胀
难以体现业务领域的概念和关系

明确划分业务逻辑与技术实现
目录结构反映业务领域模型
天然支持模块化和微服务拆分
更容易实施单元测试和领域测试

以下是基于 DDD 的技能管理系统目录结构设计：

skill-management-system/
│
├── interfaces/               # 对外接口层
│   ├── rest/                 # REST API 定义
│   ├── graphql/              # GraphQL 定义
│   └── cli/                  # 命令行接口
│
├── application/              # 应用服务层
│   ├── commands/             # CQRS 命令
│   ├── queries/              # CQRS 查询
│   └── services/             # 应用服务
│
├── domain/                   # 领域层
│   ├── models/               # 领域模型
│   ├── repositories/         # 仓储接口
│   ├── services/             # 领域服务
│   └── events/               # 领域事件
│
└── infrastructure/           # 基础设施层
    ├── persistence/          # 持久化实现
    ├── messaging/            # 消息队列实现
    └── cache/                # 缓存实现

接口层 (interfaces)
处理 HTTP 请求和响应
参数校验和 DTO 转换
不包含业务逻辑
应用层 (application)
协调领域对象完成用例
事务管理
安全控制
领域层 (domain)
业务核心逻辑
领域模型定义
业务规则实现
基础设施层 (infrastructure)
技术细节实现
数据库访问
第三方服务集成

# domain/models/skill.py
class Skill:
    """技能领域模型"""
    def __init__(self, id: str, name: str, level: int):
        self.id = id
        self.name = name
        self.level = level

    def upgrade(self):
        """升级技能等级"""
        self.level += 1

# infrastructure/persistence/skill_repository.py
class SkillRepository:
    """技能仓储实现"""
    def save(self, skill: Skill):
        # 数据库保存实现
        pass

# application/services/skill_service.py
class SkillService:
    """技能应用服务"""
    def __init__(self, repository):
        self.repository = repository

    def upgrade_skill(self, skill_id: str):
        """升级指定技能"""
        skill = self.repository.get(skill_id)
        skill.upgrade()
        self.repository.save(skill)

// domain/model/Skill.java
public class Skill {
    private String id;
    private String name;
    private int level;

    public void upgrade() {this.level++;}
}

// infrastructure/persistence/SkillRepositoryImpl.java
@Repository
public class SkillRepositoryImpl implements SkillRepository {
    @Override
    public void save(Skill skill) {// JPA 实现}
}

// application/service/SkillService.java
@Service
public class SkillService {
    private final SkillRepository repository;

    public void upgradeSkill(String skillId) {Skill skill = repository.findById(skillId);
        skill.upgrade();
        repository.save(skill);
    }
}