一眼结构#

business3 v3.1.30+88，商城 + 订单 + 优惠券 + 积分 + 钱包 + 购物车，lib/ 下按 kit_* 分业务包（kit_mall/kit_order/kit_coupon/kit_wallet/kit_shopping_cart…），base/ 沉淀通用能力——按业务垂直 slicing，而不是按技术横向分层，商城这种多业务 App 这样拆最耐改。

核心选型#

• 状态管理 GetX 4.7.3：路由 + 依赖注入 + 响应式一把梭，中小团队效率最高的选择
• 网络 dio 5.9.0 + pretty_dio_logger：拦截器统一加签/鉴权，日志拦截器联调期保留
• 本地 hive_ce + shared_preferences：重数据（缓存）走 hive 盒子，轻配置走 prefs，分级存储
• 安全 encrypt + flutter_dotenv：加解密 + .env 环境隔离，密钥不进代码（config/.env 还进了 assets，注意别把生产密钥打进包——这就是 dotenv + 多环境要配合的点，下篇细说）

git 依赖：爽但要 pin#

1
pull_to_refresh_flutter3:
2
  git:
3
    url: https://gitee.com/huanglingbin/pull_to_refresh_flutter3.git

两个组件直接引了 gitee fork（官方版停更，fork 修了 Flutter 3 兼容）。git 依赖一时爽，不 pin commit 哪天上游 force-push 就构建失败。我的习惯：git 依赖必须带 ref，定期手动 bump。

依赖清单就是架构文档：状态、网络、存储、安全、三方，一行一个决策。