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