# Studio

**Repository Path**: yin-yibing/studio

## Basic Information

- **Project Name**: Studio
- **Description**: 摄影预约小程序+后台管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-01-04
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 童年时光写真预约管理系统

## 项目简介

一套完整的儿童写真馆预约管理系统，包含 **Spring Boot 后端**、**Vue 3 PC管理端**、**微信小程序客户端** 三大模块。
![输入图片说明](image/mini1.png)
![输入图片说明](image/mini2.png)
![输入图片说明](image/pc0.png)
![输入图片说明](image/pc.png)
![输入图片说明](image/pc3.png)
![输入图片说明](image/pc4.png)
![输入图片说明](image/pc5.png)
![输入图片说明](image/pc6.png)

## 技术栈

| 模块 | 技术 |
|------|------|
| 后端 | Spring Boot 3.2 + JDK 17 + MyBatis-Plus + Spring Security + JWT |
| 数据库 | MySQL 8.x |
| PC前端 | Vue 3 + Element Plus + Pinia + ECharts + Vite |
| 小程序 | 微信原生小程序 |

## 角色权限

| 角色 | 说明 |
|------|------|
| **店长 (ADMIN)** | 数据看板、主题/套餐/摄影师/排期/订单/客户/优惠券/售后 全模块管理 |
| **摄影师 (PHOTOGRAPHER)** | 我的订单、排期查看、成片上传、个人资料管理 |
| **客户 (CUSTOMER)** | 浏览主题套餐、预约拍摄、订单管理、优惠券、售后申请（小程序端） |

## 项目结构

```
2.17ding/
├── backend/                    # Spring Boot 后端
│   ├── sql/schema.sql          # 数据库建表脚本
│   ├── src/main/java/com/childhood/photostudio/
│   │   ├── common/             # 通用类 (Result, Exception, Enum)
│   │   ├── config/             # 配置类 (MyBatis-Plus, Web)
│   │   ├── security/           # Spring Security + JWT
│   │   ├── entity/             # 实体类
│   │   ├── dto/                # 请求DTO
│   │   ├── vo/                 # 响应VO
│   │   ├── mapper/             # MyBatis-Plus Mapper
│   │   ├── service/            # Service 接口
│   │   ├── service/impl/       # Service 实现
│   │   └── controller/         # RESTful Controller
│   │       ├── admin/          # 店长接口
│   │       ├── photographer/   # 摄影师接口
│   │       └── customer/       # 客户接口
│   └── src/main/resources/
│       └── application.yml     # 应用配置
├── frontend-pc/                # Vue 3 PC管理端
│   ├── src/
│   │   ├── api/                # API 接口封装
│   │   ├── layout/             # 布局组件
│   │   ├── router/             # 路由配置
│   │   ├── stores/             # Pinia 状态管理
│   │   ├── styles/             # 全局样式
│   │   ├── utils/              # 工具类 (axios封装)
│   │   └── views/              # 页面组件
│   │       ├── admin/          # 店长页面
│   │       └── photographer/   # 摄影师页面
│   └── vite.config.js
└── miniprogram/                # 微信小程序
    ├── pages/
    │   ├── index/              # 首页
    │   ├── theme/              # 主题浏览
    │   ├── photographer/       # 摄影师浏览
    │   ├── booking/            # 预约下单
    │   ├── order/              # 订单管理
    │   ├── profile/            # 个人中心
    │   ├── coupon/             # 优惠券
    │   └── login/              # 登录注册
    ├── app.js
    ├── app.json
    └── app.wxss
```

## 快速开始

### 1. 数据库初始化

```sql
-- 创建数据库并导入表结构
mysql -u root -p < backend/sql/schema.sql
```

默认管理员账号：`admin` / `admin123`

### 2. 启动后端

```bash
cd backend
# 确保 MySQL 已启动，配置正确
mvn spring-boot:run
# 后端运行在 http://localhost:8088/api
# Swagger文档: http://localhost:8088/api/doc.html
```

### 3. 启动PC前端

```bash
cd frontend-pc
npm install
npm run dev
# 前端运行在 http://localhost:5173
# 已配置代理转发 /api -> localhost:8088
```

### 4. 微信小程序

1. 使用微信开发者工具打开 `miniprogram` 目录
2. 修改 `app.js` 中的 `baseUrl` 为后端地址
3. 编译运行

## 核心配置

| 配置项 | 值 |
|--------|-----|
| 后端端口 | `8088` |
| 上下文路径 | `/api` |
| MySQL | `localhost:3306/photo_studio` (root/root) |
| JWT Secret | 见 `application.yml` |
| JWT有效期 | 24小时 |
| 文件上传目录 | `./uploads` |
| 前端端口 | `5173` |

## API 模块

| 路径前缀 | 说明 | 权限 |
|----------|------|------|
| `/api/auth/**` | 认证（登录/注册/微信登录） | 公开 |
| `/api/public/**` | 公开数据（主题/套餐/摄影师/排期） | 公开 |
| `/api/file/**` | 文件上传 | 登录用户 |
| `/api/admin/**` | 店长管理接口 | ADMIN |
| `/api/photographer/**` | 摄影师接口 | PHOTOGRAPHER |
| `/api/customer/**` | 客户接口 | CUSTOMER |

## 数据库表

| 表名 | 说明 |
|------|------|
| sys_user | 系统用户 |
| photographer_profile | 摄影师档案 |
| photo_theme | 拍摄主题 |
| photo_package | 拍摄套餐 |
| schedule_slot | 排期时段 |
| booking_order | 预约订单 |
| order_status_log | 订单状态日志 |
| follow_up_record | 跟单记录 |
| photo_delivery | 成片交付 |
| after_sale | 售后管理 |
| coupon_template | 优惠券模板 |
| user_coupon | 用户优惠券 |
| marketing_activity | 营销活动 |
| sys_config | 系统配置 |
| sample_photo | 样片 |