yuezi-saas/docs/01-technical-overview.md

宫中有喜 — 技术方案总览

一、项目概述

项	值
项目名称	宫中有喜月子会所综合管理系统
系统类型	多门店 SaaS 管理平台 + 客户端小程序
后端	PHP 8.1+ / Laravel 10
数据库	MySQL 8.0
前端（后台）	Vue 3 + Element Plus（SPA，自适应）
前端（客户端）	微信小程序（uni-app，可复用 Vue 组件）
API 风格	RESTful JSON，统一前缀 /api/v1/
部署	Nginx + PHP-FPM / Docker Compose

二、框架选型理由

后端：Laravel 10

• Eloquent ORM：模型关联、软删除、Scope 过滤（门店隔离天然支持）
• 中间件体系：RBAC 权限、门店隔离、操作日志 一站式拦截
• 队列 & 事件：短信、推送、异步报表 开箱即用
• Sanctum：后台 SPA token + 小程序 API token 双模认证
• Migration & Seeder：数据库版本控制，多人协作无冲突
• 生态成熟：社区、文档、第三方包（Excel 导出、PDF、微信SDK）齐全

前端：Vue 3 + Element Plus

• 与 Laravel 前后分离配合成熟
• Element Plus 提供完整后台组件（表格、表单、日历、审批流）
• 响应式布局满足 Web + Mobile 自适应需求

客户端：uni-app

• 一套代码编译微信小程序 + H5
• Vue 3 语法，与后台前端技术栈统一，降低学习成本
• 丰富的插件市场（微信支付、地图、视频播放等）

三、系统架构图

┌─────────────────────────────────────────────────┐
│                    客户端                        │
│  ┌──────────────┐  ┌──────────────────────────┐ │
│  │ 微信小程序    │  │ 后台管理 SPA (Vue3)      │ │
│  │ (uni-app)    │  │ Element Plus             │ │
│  └──────┬───────┘  └───────────┬──────────────┘ │
└─────────┼──────────────────────┼────────────────┘
          │ HTTPS                │ HTTPS
          ▼                      ▼
┌─────────────────────────────────────────────────┐
│              Nginx 反向代理 / 负载均衡            │
│         静态资源 + API 路由 + WebSocket          │
└─────────────────────┬───────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────┐
│              Laravel 10 API 层                   │
│  ┌────────┐ ┌────────┐ ┌────────┐ ┌──────────┐ │
│  │ 认证   │ │ RBAC   │ │ 门店   │ │ 操作日志 │ │
│  │中间件  │ │中间件  │ │隔离    │ │中间件    │ │
│  └───┬────┘ └───┬────┘ └───┬────┘ └────┬─────┘ │
│      └──────────┴──────────┴────────────┘       │
│  ┌──────────────────────────────────────────┐   │
│  │           Controller 层 (13模块)          │   │
│  │  CRM | 房务 | 护理 | 月子餐 | 产康       │   │
│  │  月嫂 | 进销存 | 财务 | 人事 | 协同       │   │
│  │  报表 | 知识库 | 系统设置                  │   │
│  └──────────────────┬───────────────────────┘   │
│  ┌──────────────────▼───────────────────────┐   │
│  │           Service 层 (业务逻辑)           │   │
│  └──────────────────┬───────────────────────┘   │
│  ┌──────────────────▼───────────────────────┐   │
│  │         Model 层 (Eloquent ORM)           │   │
│  └──────────────────┬───────────────────────┘   │
└─────────────────────┼───────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────┐
│                   数据层                         │
│  ┌──────────┐  ┌──────────┐  ┌───────────────┐ │
│  │ MySQL 8  │  │ Redis    │  │ 文件存储      │ │
│  │ 主业务库  │  │ 缓存/队列│  │ (本地/OSS)   │ │
│  └──────────┘  └──────────┘  └───────────────┘ │
└─────────────────────────────────────────────────┘

四、项目目录结构

saas/
├── backend/                    # Laravel 后端
│   ├── app/
│   │   ├── Http/
│   │   │   ├── Controllers/
│   │   │   │   ├── Admin/      # 后台管理接口
│   │   │   │   │   ├── Crm/    # 5.1 CRM模块
│   │   │   │   │   ├── Room/   # 5.2 房务模块
│   │   │   │   │   ├── Care/   # 5.3 护理模块
│   │   │   │   │   ├── Meal/   # 5.4 月子餐模块
│   │   │   │   │   ├── Service/# 5.5 服务产康
│   │   │   │   │   ├── Nanny/  # 5.6 月嫂模块
│   │   │   │   │   ├── Stock/  # 5.7 进销存
│   │   │   │   │   ├── Finance/# 5.8 财务模块
│   │   │   │   │   ├── Hr/     # 5.9 人事薪资
│   │   │   │   │   ├── Office/ # 5.10 办公协同
│   │   │   │   │   ├── Report/ # 5.11 统计报表
│   │   │   │   │   ├── Kb/     # 5.12 知识库
│   │   │   │   │   └── System/ # 5.13 系统设置
│   │   │   │   └── Client/     # 微客宝客户端接口
│   │   │   ├── Middleware/
│   │   │   │   ├── StoreIsolation.php
│   │   │   │   ├── CheckPermission.php
│   │   │   │   └── OperationLog.php
│   │   │   └── Requests/       # 表单验证
│   │   ├── Models/             # Eloquent 模型
│   │   ├── Services/           # 业务逻辑层
│   │   ├── Enums/              # 枚举常量
│   │   ├── Events/             # 事件
│   │   ├── Listeners/          # 监听器
│   │   ├── Jobs/               # 队列任务
│   │   └── Traits/             # 公用 Trait
│   ├── database/
│   │   ├── migrations/         # 数据库迁移
│   │   └── seeders/            # 种子数据
│   ├── routes/
│   │   ├── api.php             # 后台 API 路由
│   │   └── client.php          # 客户端 API 路由
│   └── config/
│
├── frontend/                   # Vue 3 后台前端
│   ├── src/
│   │   ├── views/              # 页面（按模块分目录）
│   │   ├── components/         # 公共组件
│   │   ├── api/                # 接口封装
│   │   ├── stores/             # Pinia 状态管理
│   │   ├── router/             # 路由（动态菜单）
│   │   ├── utils/              # 工具函数
│   │   └── assets/             # 静态资源
│   └── vite.config.js
│
├── miniapp/                    # uni-app 微信小程序
│   ├── pages/                  # 页面
│   ├── components/             # 组件
│   ├── api/                    # 接口
│   ├── stores/                 # 状态
│   └── static/                 # 静态资源
│
├── docs/                       # 技术文档
│   ├── 01-technical-overview.md
│   ├── 02-database-design.md
│   ├── 03-api-specification.md
│   ├── 04-rbac-design.md
│   ├── 05-module-details.md
│   ├── 06-miniapp-design.md
│   └── 07-deployment.md
│
├── docker-compose.yml
└── README.md

五、开发阶段规划

第一阶段：基础框架（2周）

• Laravel 项目搭建 + 数据库迁移框架
• RBAC 权限系统（用户、角色、权限、菜单）
• 门店隔离中间件
• 操作日志中间件
• 审批流引擎基础
• Vue 3 后台框架 + 动态路由 + 登录认证
• 系统设置模块（门店、部门、角色、用户）

第二阶段：核心业务（4周）

• CRM 模块（线索、客户、签约、问卷）
• 房务模块（房态、预定、入离住）
• 护理模块（档案、计划、记录、异常、指标）
• 月子餐模块（排餐、送餐、评价）

第三阶段：增值 & 供应链（3周）

• 服务与产康模块
• 月嫂模块
• 进销存模块

第四阶段：财务 & 人事（2周）

• 财务模块
• 人事薪资模块

第五阶段：协同 & 报表（2周）

• 办公协同模块
• 统计报表模块
• 知识库模块

第六阶段：微客宝小程序（3周）

• uni-app 项目搭建
• 首页（商城、点餐、学堂、月嫂、活动）
• 共伴成长（护理记录、数据图表）
• 个人中心（账户、订单、服务、评价）

第七阶段：联调 & 部署（2周）

• 前后端联调
• 微信支付对接
• 性能优化
• Docker 部署
• 上线验收