模块化单体架构：我在个人博客项目中的实践

personal-blog-backend/
├── blog-common/               # 公共基础模块（工具类、异常、基础框架）
├── blog-modules/
│   ├── blog-module-system/    # 用户/角色/认证
│   │   ├── blog-system-api/   # 契约层：DTO、VO、Interface
│   │   └── blog-system-service/ # 实现层：Controller、Service、Entity
│   ├── blog-module-article/   # 文章/分类/标签
│   ├── blog-module-comment/   # 评论/审核/举报
│   └── blog-module-file/      # 文件上传（S3 兼容）
└── blog-application/          # 启动入口 + 全局配置 + Flyway 迁移

// blog-system-api 模块中的跨模块接口
public interface RemoteUserService {
    UserDTO getUserById(Long userId);
    List<UserDTO> getUsersByIds(List<Long> userIds);
}

blog-application  ──→  所有 *-service

blog-*-service    ──→  blog-*-api（自己的 API）
                  ──→  blog-common
                  ──→  其他模块的 *-api（跨模块调用）

blog-*-api        ──→  blog-common

-- ❌ 禁止：文章模块直接 JOIN 用户表
SELECT a.*, u.username
FROM art_article a
JOIN sys_user u ON a.author_id = u.id

// ✅ 正确做法
List<ArticleEntity> articles = articleMapper.selectList(wrapper);

List<Long> authorIds = articles.stream()
    .map(ArticleEntity::getAuthorId)
    .toList();

// 通过接口（将来可以替换为 Feign Client）
List<UserDTO> users = remoteUserService.getUsersByIds(authorIds);

@ArchTest
static final ArchRule services_should_not_depend_on_other_services =
    noClasses()
        .that().resideInAPackage("..service..")
        .should().dependOnClassesThat()
        .resideInAPackage("..other.service..");

// 当前：本地 Bean 调用
@Service
public class RemoteUserServiceImpl implements RemoteUserService {
    private final UserService userService;
    // 直接调用
}

// 微服务化后：只需替换实现类
@FeignClient(name = "user-service")
public interface RemoteUserService {
    @GetMapping("/api/v1/users/{id}")
    UserDTO getUserById(@PathVariable Long id);
}