5.4 KiB
5.4 KiB
湖南12301文旅综合平台 - 规格说明书
文档版本：v1.0 最后更新：2026-06-13
一、项目基本信息
| 项 | 内容 |
|---|---|
| 项目名称 | 湖南12301文旅综合平台 |
| 技术栈 | uni-app + Vue 3 + Composition API + TypeScript + Pinia + uni-ui |
| 构建工具 | Vite |
| 环境配置 | local / dev / uat 三套 |
| 接口架构 | 后端统一 API 层封装所有第三方 |
| 目标平台 | 微信小程序 + H5 + App（Android/iOS） |
二、双端架构
2.1 目录结构
湖南12301/
├── src/
│ ├── pages/ # 主包（共享页面）
│ │ ├── index/ # 首页（双端入口选择）
│ │ └── login/ # 登录页
│ ├── packages/
│ │ ├── admin/ # 【综合管理端】商家/管理员
│ │ │ └── pages/
│ │ │ ├── index/ # 管理端首页
│ │ │ ├── card/ # 卡管理
│ │ │ └── scenic/ # 景区管理
│ │ └── user/ # 【文旅专区端】C端用户
│ │ └── pages/
│ │ ├── index/ # 用户端首页
│ │ ├── card/ # 年卡购买/激活/绑定/入园码
│ │ ├── rights/ # 权益查看（免票景区/特惠商品）
│ │ ├── scenic/ # 景区预约
│ │ ├── booking/ # 预约记录
│ │ ├── usage/ # 使用记录
│ │ └── profile/ # 个人中心（我的年卡/订单）
│ ├── components/ # 共享组件
│ ├── api/ # 共享接口层
│ ├── store/ # Pinia 共享状态
│ └── utils/ # 工具函数
2.2 发布模式
| 模式 | 编译命令 | 说明 |
|---|---|---|
| 聚合版 | npm run build:all |
双端合一，首页选择入口 |
| 管理端独立版 | npm run build:admin |
商家/管理员独立小程序 |
| 用户端独立版 | npm run build:user |
C端用户独立小程序 |
三、综合管理端功能（商家/管理员）
3.1 TabBar 设计
| Tab | 路由 | 说明 |
|---|---|---|
| 🏠 | 首页 | 数据概览 |
| 🎫 | 卡管理 | 年卡列表/编辑 |
| 📍 | 景区管理 | 景区列表/编辑 |
| 👤 | 我的 | 个人设置 |
3.2 功能模块
| 模块 | 路由 | 功能 |
|---|---|---|
| 首页 | /packages/admin/pages/index/index |
数据概览（待扩展） |
| 卡管理 | /packages/admin/pages/card/list |
年卡列表、创建/编辑年卡 |
| 景区管理 | /packages/admin/pages/scenic/list |
景区列表、创建/编辑景区 |
四、文旅专区端功能（C端用户）
4.1 TabBar 设计
| Tab | 路由 | 说明 |
|---|---|---|
| 🏠 | 首页 | 年卡展示、推荐景区、Banner |
| 🎫 | 权益 | 免票景区、特惠商品 |
| 👤 | 我的 | 我的年卡、订单、预约、积分等 |
4.2 功能模块
| 序号 | 模块 | 路由 | 功能 |
|---|---|---|---|
| 1 | 年卡购买 | /packages/user/pages/card/buy |
卡种列表 → 选择卡种 → 确认订单 → 微信支付 |
| 2 | 年卡激活 | /packages/user/pages/card/activate |
激活已购买的年卡 |
| 3 | 年卡绑定 | /packages/user/pages/card/bind |
输入卡号绑定已有年卡 |
| 4 | 入园码 | /packages/user/pages/card/qrcode |
生成/展示入园二维码 |
| 5 | 权益查看 | /packages/user/pages/rights/index |
免票景区列表、特惠商品列表（含搜索/筛选/排序） |
| 6 | 景区预约 | /packages/user/pages/scenic/book |
选择景区 → 选择时间 → 确认预约 |
| 7 | 预约记录 | /packages/user/pages/booking/list |
查看/取消已预约记录 |
| 8 | 使用记录 | /packages/user/pages/usage/list |
已入园/已使用记录 |
| 9 | 订单管理 | /packages/user/pages/profile/order |
全部/待支付/已完成订单 |
| 10 | 我的年卡 | /packages/user/pages/profile/my-card |
已购年卡列表、到期时间 |
4.3 权益查看子功能
| 功能 | 说明 |
|---|---|
| 搜索 | 关键词搜索景区/商品 |
| 分类筛选 | 按分类筛选（景区/影院/温泉/亲子乐园等） |
| 排序 | 按距离/热度/时间排序 |
4.4 核心业务流程
购买年卡：
年卡展示 → 选择卡种 → 微信支付 → 支付成功 → 年卡激活 → 我的年卡
权益使用：
查看权益 → 选择景区 → 景区预约 → 生成入园码 → 入园核销 → 使用记录
年卡绑定：
已有年卡 → 输入卡号 → 验证 → 绑定成功 → 查看权益
五、API 接口模块
| 模块 | 接口描述 |
|---|---|
| 用户模块 | 登录、获取用户信息 |
| 年卡模块 | 卡种列表、卡种详情、年卡激活、年卡绑定、我的年卡列表 |
| 权益模块 | 免票景区列表、特惠商品列表、景区/商品详情 |
| 预约模块 | 创建预约、取消预约、预约列表 |
| 核销模块 | 生成入园码、验证入园码 |
| 订单模块 | 创建订单、微信支付、订单列表、订单详情 |
六、环境配置
| 环境 | 标识 | 用途 |
|---|---|---|
| 本地开发 | local |
本机开发调试 |
| 测试环境 | dev |
团队联调、测试验证 |
| 预发布环境 | uat |
生产环境验证、灰度测试 |