设计原则

灵萌 V2 采用 Go 模块化单体 + uni-app X 四端 架构：

• 30 个业务模块遵循统一五层结构（handler → service → repository → model → dto）
• 横切能力（缓存、锁、Outbox、通知、账本等）沉淀在 pkg/ 与 infrastructure/
• bootstrap/wiring 统一装配，支持 full（API + 任务）与 worker（仅后台任务）启动模式

flowchart TB
  subgraph Client["客户端"]
    App[App / 小程序 / H5]
    Admin[管理后台 H5]
  end

  subgraph Server["灵萌服务端"]
    API[HTTP / WebSocket API]
    Modules[30 业务模块]
    PKG[pkg 工具库]
    Infra[基础设施]
  end

  subgraph Data["数据与中间件"]
    MySQL[(MySQL)]
    Redis[(Redis)]
    MS[Meilisearch 可选]
  end

  App --> API
  Admin --> API
  API --> Modules
  Modules --> PKG
  Modules --> Infra
  Infra --> MySQL
  Infra --> Redis
  Infra --> MS

模块与能力

对外以功能模块形式交付（社区、消息、支付、外卖、AI 等），可按区域与授权开关启用。

完整清单见 功能模块总览（不含价格，含配置文档链接）。

相关文档

文档	说明
功能模块总览	全部模块能力说明与配置入口
快速部署	首次安装与启动
系统配置总览	微信、存储、地图等基础配置

二次开发

若需阅读代码结构、数据库迁移、架构守卫等开发内容，请参考项目仓库内 docs/ 目录与 DEVELOPMENT_GUIDELINES.md。