hello-arch

架构相关变更必须遵循以下规范。

编码前

先画出当前→目标依赖关系和变更路径，再写代码。

SOLID 原则

• 单一职责：一个模块/类只做一件事，变更只有一个原因
• 开闭原则：扩展开放，修改关闭——新功能通过扩展实现
• 依赖倒置：高层不依赖低层，都依赖抽象（接口/协议）

边界与分层

• 清晰的模块边界，通过接口通信
• 依赖方向：外层 → 内层（UI → Service → Repository）
• 循环依赖 = 架构问题，必须解决
• 配置与代码分离，环境变量管理

代码组织

• 按功能分组（feature-based），非按类型分组
• 代码体积控制（同当前已加载 bootstrap 的编码原则）：文件/类预警 300 行、强制拆分 400 行，函数预警 40 行、强制拆分 60 行。例外：生成代码、大型测试夹具、迁移脚本、协议常量表