Skip to content

完整应用 ​

基于 MengStack 软盟大基座与 MengHub 客户端基座构建的完整业务应用,展示两大基座在实际业务场景中的应用方式。

统一技术栈 ​

所有应用共享同一套产品级技术栈,后端、Web 前端、客户端、数据层均已定型。

后端基座 — MengStack(Go) ​

分类技术版本用途
语言Go1.26后端主语言
Web 框架Ginv1.10.0HTTP 路由与中间件
ORMGORMv1.25.12数据访问层(pgx/v5 驱动)
数据库驱动gorm.io/driver/postgresv1.5.9PostgreSQL 连接
缓存go-redisv9.7.3Redis 客户端
依赖注入uber-go/fxv1.23.0模块化装配与生命周期
日志uber-go/zapv1.27.0结构化日志
配置Viperv1.19.0分层配置管理
认证golang-jwtv5.3.1JWT 双 Token
实时通信gorilla/websocketv1.5.3WebSocket Hub
任务调度gocronv2.22.0定时任务
数据迁移golang-migratev4.20.1Schema 版本管理
对象存储aws-sdk-go-v2 (S3)v1.47.1S3 / OSS / MinIO
加密golang.org/x/cryptov0.54.0bcrypt 密码哈希

架构特征:

  • DDD 四层架构:domain → application → infrastructure → interfaces
  • 多租户隔离:X-Tenant-ID 请求头 + GORM Scope 全局过滤
  • 插件系统:声明式扩展点 + 六维权限沙箱
  • 统一响应:{code, message, data, trace_id}
  • 中间件链:RequestID → 日志 → 安全头 → CharsetUTF8 → CORS → AcceptLanguage → 限流 → BodyLimit(10MB) → Recovery

Web 管理端 — Vue 3 + Element Plus ​

分类技术版本用途
框架Vue3.5组合式 API + <script setup>
语言TypeScript5.6全量类型安全
构建Vite6.0秒级热更新
路由vue-router4.5SPA 路由
状态管理Pinia2.3模块化 Store
UI 组件库Element Plus2.9企业级组件
图标@element-plus/icons-vue2.3官方图标集
HTTPaxios1.7拦截器统一鉴权
图表ECharts + vue-echarts5.5 / 7.0仪表盘可视化
富文本Tiptap3.31富文本编辑器(全套扩展)
组合式工具@vueuse/core12.4常用 Composables
国际化vue-i18n10.0中英文切换
工程化unplugin-auto-import / unplugin-vue-components—自动按需引入
样式Sass1.83CSS 预处理

官网 — Nuxt 3 SSR ​

分类技术版本用途
框架Nuxt3.16SSR 服务端渲染(SEO 友好)
视图层Vue3.5组合式 API
路由vue-router4.5文件路由

面向搜索引擎(含百度蜘蛛)采用 SSR,通过 Nuxt Server Routes 代理 /api/* 到后端基座。

演示站前端 — portal + workspace ​

演示站采用双前端形态:门户前台用 Nuxt SSR(SEO 友好),用户工作台用 Vite SPA(交互密集)。

portal 门户前台(Nuxt SSR):

分类技术版本用途
框架Nuxt3.13SSR 服务端渲染
视图层Vue3.5组合式 API
路由vue-router4.4文件路由
富文本Tiptap3.31内容渲染(精简扩展集)

workspace 用户工作台(Vite SPA):

分类技术版本用途
框架Vue3.5组合式 API
语言TypeScript5.6全量类型安全
构建Vite6.0秒级热更新
路由vue-router4.5SPA 路由
状态管理Pinia2.3模块化 Store
UI 组件库Element Plus2.9企业级组件
富文本Tiptap3.31富文本编辑器
HTTPaxios1.7拦截器统一鉴权
国际化vue-i18n10.0中英文切换

客户端基座 — MengHub(Flutter) ​

分类技术版本用途
框架Flutter3.13.5+一套代码覆盖 Android / iOS
语言Dart3.13.5+客户端主语言
HTTPdio5.11拦截器链 + 自动重试
WebSocketweb_socket_channel3.0IM 实时消息
本地数据库sqflite_sqlcipher3.1SQLCipher 全库加密
安全存储flutter_secure_storage11.0Token 存 Keychain/Keystore
路由go_router18.0声明式路由(22 条)
依赖注入get_it9.08 个全局单例服务
状态管理provider6.1页面级状态
序列化json_serializable + build_runner6.86 个数据模型代码生成
加密crypto3.0SHA-256 指纹
媒体与文件image_picker / file_picker / cached_network_image / open_file—拍照、选择、缓存、预览
设备能力permission_handler / device_info_plus / connectivity_plus / share_plus—权限、设备、网络、分享
动效lottie3.6品牌动画
国际化intl0.20中英文 41 键
测试mocktail1.0单元测试 Mock

平台要求:

  • Android:compileSdk 37 / targetSdk 35 / minSdk 24(Android 7.0+)
  • iOS:12.0+
  • 深色主题为默认主题,品牌金色 #EFC25C

数据层与基础设施 ​

组件版本用途
PostgreSQL16+主数据库(RLS 行级安全、JSONB、全文检索)
Redis7+缓存、会话、限流、刷新令牌指纹、消息队列
S3 / MinIO—文件与媒体对象存储
Nginx—反向代理 + WebSocket 升级 + 静态资源
Docker / docker-compose—一键编排部署
PM2—Node.js 进程管理(官网 SSR)

应用列表 ​

电商应用 (ecommerce) ​

完整的电商解决方案,包含商品管理、订单系统、支付集成、物流跟踪和营销活动。

技术栈:

  • 后端:MengStack v2.5.8(Go 1.26 + Gin + GORM)
  • 管理端:Vue 3.5 + Element Plus 2.9 + ECharts
  • 数据库:PostgreSQL 16 + Redis 7
  • 存储:S3 / MinIO 商品图与附件

核心模块:

  • 商品管理(SPU/SKU、分类、属性)
  • 订单系统(下单、支付、退款)
  • 支付集成(支付宝、微信支付)
  • 物流跟踪(多快递公司对接)
  • 营销活动(优惠券、满减、秒杀)

社交应用 (social) ​

社交网络平台,包含用户动态、话题讨论、评论互动、关注系统和消息推送。

技术栈:

  • 后端:MengStack v2.5.8(Go 1.26 + Gin + GORM)
  • 实时通信:gorilla/websocket(16 分片 Hub,房间广播)
  • 客户端:MengHub(Flutter 3.13,秒圈动态 + IM)
  • 数据库:PostgreSQL 16 + Redis 7(离线消息缓存)

核心模块:

  • 用户动态(发布、点赞、收藏)
  • 话题讨论(话题创建、回复、热门排序)
  • 关注系统(关注、粉丝、推荐)
  • 消息推送(站内信、系统通知)

直播购物 (live) ​

直播电商平台,包含直播间管理、商品挂载、实时互动、订单转化和数据统计。

技术栈:

  • 后端:MengStack v2.5.8(Go 1.26 + Gin + GORM)
  • 直播推拉流:WebRTC / RTMP
  • 实时互动:gorilla/websocket(弹幕、点赞)
  • 管理端:Vue 3.5 + Element Plus 2.9
  • 数据库:PostgreSQL 16 + Redis 7(直播间热度计数)

核心模块:

  • 直播间管理(创建、排期、回放)
  • 商品挂载(选品、上架、库存)
  • 实时互动(弹幕、点赞、红包)
  • 订单转化(直播间下单、优惠)
  • 数据统计(观看、转化、GMV)

应用架构 ​

┌──────────────────────────────────────────────────┐
│  客户端层                                          │
│  Flutter 3.13 (MengHub)  │  Vue 3.5 (管理端)      │
│  Nuxt 3.16 SSR (官网)                              │
└──────────────────────────────────────────────────┘
                       ↓ HTTPS / WSS
┌──────────────────────────────────────────────────┐
│  Nginx 反向代理(WebSocket 升级 / 静态资源)        │
└──────────────────────────────────────────────────┘
                       ↓
┌──────────────────────────────────────────────────┐
│  MengStack 软盟大基座 (Go 1.26 + Gin + fx)        │
│  ┌──────────────────────────────────────────┐   │
│  │  业务模块(插件沙箱)                      │   │
│  │  auth / rbac / org / audit / settings    │   │
│  │  notification / dashboard / 25+ 业务插件  │   │
│  └──────────────────────────────────────────┘   │
└──────────────────────────────────────────────────┘
                       ↓
┌──────────────────────────────────────────────────┐
│  PostgreSQL 16 (RLS)  │  Redis 7  │  S3/MinIO    │
└──────────────────────────────────────────────────┘

快速开始 ​

1. 克隆应用 ​

bash
git clone https://mengstackgit.softunis.com/softunis/mengstack-kernel-dist.git
cd mengstack-kernel-dist

2. 配置环境 ​

bash
cp .env.example .env
# 编辑 .env,配置 PostgreSQL / Redis / S3

3. 启动应用 ​

bash
go mod download
make migrate   # 数据库迁移
make run       # 启动服务(默认端口 2222)

应用开发指南 ​

创建新应用 ​

在发行版源码 internal/modules/ 下新建业务模块目录,遵循 DDD 四层架构(domain → application → infrastructure → interfaces)。

定义业务模块 ​

bash
go run ./cmd/smrm new module product
go run ./cmd/smrm new module order

脚手架会自动生成四层架构骨架代码,每个模块包含:

  • domain/ — 实体定义和仓储接口
  • application/ — 业务服务
  • infrastructure/ — GORM 仓储实现和 SQL 迁移
  • interfaces/ — HTTP 处理器和路由注册

集成基座能力 ​

应用自动继承基座能力:

  • 多租户隔离(GORM Scope + RLS)
  • 用户认证(JWT 双 Token)
  • 权限管理(RBAC 60+ 权限)
  • 审计日志
  • 配置管理
  • WebSocket 实时推送

代码组织 ​

my-app/
├── cmd/                # 应用入口
├── internal/
│   ├── modules/        # 业务模块(DDD 四层)
│   │   ├── product/
│   │   ├── order/
│   │   └── payment/
│   └── config/         # 应用配置
├── configs/            # 配置文件
└── deployments/        # 部署配置

相关资源 ​

最后更新于:

Released under the Apache 2.0 License.