Flutter GetX 三层架构规范

架构概览

纵向分层（自上而下单向依赖，modules 依赖 core 和 shared）：

shared（底）← core ← modules（顶）

模块内 GetX 结构：

Binding（注入） + View ← Logic → State

层级速查

层级	职责
core	配置、路由、服务、工具、通用 UI 组件
shared	业务基类、存储、网络、可复用能力
modules	业务功能实现，按功能拆模块，模块间走路由

模块目录模板

{module}/
├── {feature}/                 # 子功能（可选）
│   ├── xxx_binding.dart
│   ├── xxx_logic.dart
│   ├── xxx_state.dart
│   ├── xxx_view.dart
│   ├── model/
│   └── view/
├── binding/
├── model/
├── view/
├── db/                        # 本地数据（可选）
└── upload/                    # 上传（可选）

命名约定

• binding / logic / state / view：xxx_binding.dart → XxxBinding 等
• logic 继承项目内 BaseController 基类
• 视图文件以 _view 结尾，类名以 Page 或 View 结尾
• 避免使用 widget 作为文件或类名后缀

依赖约束

• 仅允许上层依赖下层
• 同级模块不互相 import，通过路由（Get.toNamed）通信
• Logic 不持有 BuildContext、不直接操作 UI

Scaffold 能力

用户要求创建目录、搭建架构、新建模块时：

全量：创建 core/config、constants、navigation、utils、services、widgets；shared/data、domain；modules/{name}

增量：在 modules 下新建 {module_name}/，可用 validate.py 生成页面骨架

模块名使用小写下划线（如 order_list、user_profile）。

页面生成

• 普通页：python ~/flutter-schema/scripts/validate.py <name> [dir]

完整说明见 schema.md。