Appearance
完整应用
基于 MengStack 软盟大基座与 MengHub 客户端基座构建的完整业务应用,展示两大基座在实际业务场景中的应用方式。
统一技术栈
所有应用共享同一套产品级技术栈,后端、Web 前端、客户端、数据层均已定型。
后端基座 — MengStack(Go)
| 分类 | 技术 | 版本 | 用途 |
|---|---|---|---|
| 语言 | Go | 1.26 | 后端主语言 |
| Web 框架 | Gin | v1.10.0 | HTTP 路由与中间件 |
| ORM | GORM | v1.25.12 | 数据访问层(pgx/v5 驱动) |
| 数据库驱动 | gorm.io/driver/postgres | v1.5.9 | PostgreSQL 连接 |
| 缓存 | go-redis | v9.7.3 | Redis 客户端 |
| 依赖注入 | uber-go/fx | v1.23.0 | 模块化装配与生命周期 |
| 日志 | uber-go/zap | v1.27.0 | 结构化日志 |
| 配置 | Viper | v1.19.0 | 分层配置管理 |
| 认证 | golang-jwt | v5.3.1 | JWT 双 Token |
| 实时通信 | gorilla/websocket | v1.5.3 | WebSocket Hub |
| 任务调度 | gocron | v2.22.0 | 定时任务 |
| 数据迁移 | golang-migrate | v4.20.1 | Schema 版本管理 |
| 对象存储 | aws-sdk-go-v2 (S3) | v1.47.1 | S3 / OSS / MinIO |
| 加密 | golang.org/x/crypto | v0.54.0 | bcrypt 密码哈希 |
架构特征:
- 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
| 分类 | 技术 | 版本 | 用途 |
|---|---|---|---|
| 框架 | Vue | 3.5 | 组合式 API + <script setup> |
| 语言 | TypeScript | 5.6 | 全量类型安全 |
| 构建 | Vite | 6.0 | 秒级热更新 |
| 路由 | vue-router | 4.5 | SPA 路由 |
| 状态管理 | Pinia | 2.3 | 模块化 Store |
| UI 组件库 | Element Plus | 2.9 | 企业级组件 |
| 图标 | @element-plus/icons-vue | 2.3 | 官方图标集 |
| HTTP | axios | 1.7 | 拦截器统一鉴权 |
| 图表 | ECharts + vue-echarts | 5.5 / 7.0 | 仪表盘可视化 |
| 富文本 | Tiptap | 3.31 | 富文本编辑器(全套扩展) |
| 组合式工具 | @vueuse/core | 12.4 | 常用 Composables |
| 国际化 | vue-i18n | 10.0 | 中英文切换 |
| 工程化 | unplugin-auto-import / unplugin-vue-components | — | 自动按需引入 |
| 样式 | Sass | 1.83 | CSS 预处理 |
官网 — Nuxt 3 SSR
| 分类 | 技术 | 版本 | 用途 |
|---|---|---|---|
| 框架 | Nuxt | 3.16 | SSR 服务端渲染(SEO 友好) |
| 视图层 | Vue | 3.5 | 组合式 API |
| 路由 | vue-router | 4.5 | 文件路由 |
面向搜索引擎(含百度蜘蛛)采用 SSR,通过 Nuxt Server Routes 代理 /api/* 到后端基座。
演示站前端 — portal + workspace
演示站采用双前端形态:门户前台用 Nuxt SSR(SEO 友好),用户工作台用 Vite SPA(交互密集)。
portal 门户前台(Nuxt SSR):
| 分类 | 技术 | 版本 | 用途 |
|---|---|---|---|
| 框架 | Nuxt | 3.13 | SSR 服务端渲染 |
| 视图层 | Vue | 3.5 | 组合式 API |
| 路由 | vue-router | 4.4 | 文件路由 |
| 富文本 | Tiptap | 3.31 | 内容渲染(精简扩展集) |
workspace 用户工作台(Vite SPA):
| 分类 | 技术 | 版本 | 用途 |
|---|---|---|---|
| 框架 | Vue | 3.5 | 组合式 API |
| 语言 | TypeScript | 5.6 | 全量类型安全 |
| 构建 | Vite | 6.0 | 秒级热更新 |
| 路由 | vue-router | 4.5 | SPA 路由 |
| 状态管理 | Pinia | 2.3 | 模块化 Store |
| UI 组件库 | Element Plus | 2.9 | 企业级组件 |
| 富文本 | Tiptap | 3.31 | 富文本编辑器 |
| HTTP | axios | 1.7 | 拦截器统一鉴权 |
| 国际化 | vue-i18n | 10.0 | 中英文切换 |
客户端基座 — MengHub(Flutter)
| 分类 | 技术 | 版本 | 用途 |
|---|---|---|---|
| 框架 | Flutter | 3.13.5+ | 一套代码覆盖 Android / iOS |
| 语言 | Dart | 3.13.5+ | 客户端主语言 |
| HTTP | dio | 5.11 | 拦截器链 + 自动重试 |
| WebSocket | web_socket_channel | 3.0 | IM 实时消息 |
| 本地数据库 | sqflite_sqlcipher | 3.1 | SQLCipher 全库加密 |
| 安全存储 | flutter_secure_storage | 11.0 | Token 存 Keychain/Keystore |
| 路由 | go_router | 18.0 | 声明式路由(22 条) |
| 依赖注入 | get_it | 9.0 | 8 个全局单例服务 |
| 状态管理 | provider | 6.1 | 页面级状态 |
| 序列化 | json_serializable + build_runner | 6.8 | 6 个数据模型代码生成 |
| 加密 | crypto | 3.0 | SHA-256 指纹 |
| 媒体与文件 | image_picker / file_picker / cached_network_image / open_file | — | 拍照、选择、缓存、预览 |
| 设备能力 | permission_handler / device_info_plus / connectivity_plus / share_plus | — | 权限、设备、网络、分享 |
| 动效 | lottie | 3.6 | 品牌动画 |
| 国际化 | intl | 0.20 | 中英文 41 键 |
| 测试 | mocktail | 1.0 | 单元测试 Mock |
平台要求:
- Android:compileSdk 37 / targetSdk 35 / minSdk 24(Android 7.0+)
- iOS:12.0+
- 深色主题为默认主题,品牌金色
#EFC25C
数据层与基础设施
| 组件 | 版本 | 用途 |
|---|---|---|
| PostgreSQL | 16+ | 主数据库(RLS 行级安全、JSONB、全文检索) |
| Redis | 7+ | 缓存、会话、限流、刷新令牌指纹、消息队列 |
| 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-dist2. 配置环境
bash
cp .env.example .env
# 编辑 .env,配置 PostgreSQL / Redis / S33. 启动应用
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/ # 部署配置
