151 lines
5.4 KiB
Markdown
151 lines
5.4 KiB
Markdown
# 湖南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` | 生产环境验证、灰度测试 |
|