# 智慧教务系统

## 项目概述

课程预约、消课、服务管理的企业级教务系统，支持学员端和教练端。

## 项目结构

```
zhjwxt/
├── admin/           # 管理后台 (Vue3 + Element Plus + TypeScript)
├── uniapp/          # 移动端客户端 (UniApp + Vue3 + TypeScript)
├── niucloud/        # ThinkPHP8 后端服务
├── openspec/        # OpenSpec 规范文档
├── docker/          # Docker 配置
├── doc/             # 文档目录
└── vendor/          # Composer 依赖
```

## 技术栈

| 模块 | 技术栈 |
|------|--------|
| 后端 | ThinkPHP 8.0 + MySQL + Redis |
| 管理后台 | Vue3 + Element Plus + TypeScript + Vite |
| 移动端 | UniApp + Vue3 + TypeScript + Pinia |

## 运行环境

### 数据库
- **数据库名**: `niucloud`
- **用户名**: `niucloud`
- **密码**: `niucloud123`

### 服务端口
- **后端 API**: `http://localhost:20080`
  - 客户端接口: `/api`
  - 管理端接口: `/adminapi`
- **管理后台**: `http://localhost:23000`
- **移动端 H5**: `http://localhost:8080`

### 启动命令
```bash
# 启动所有服务 (Docker)
./start.sh

# 单独启动后端
cd niucloud && php think serve

# 启动管理后台
cd admin && npm run dev

# 启动移动端
cd uniapp && npm run dev:h5
```

## 核心功能模块

### 课程管理
- 课程创建/编辑/删除
- 课程排期
- 课程类型管理

### 预约管理
- 学员预约
- 预约审核
- 预约取消/改期

### 消课管理
- 消课记录
- 消课统计
- 消课审核

### 学员管理
- 学员信息
- 学员卡管理
- 学员消费记录

### 教练管理
- 教练信息
- 教练排班
- 教练绩效

## 端点说明

### 移动端目录
| 目录 | 说明 |
|------|------|
| `pages/common/` | 通用页面（登录、设置等） |
| `pages/student/` | 学员端页面 |
| `pages/coach/` | 教练端页面 |
| `pages-coach/` | 教练端专属页面 |
| `pages-common/` | 通用页面模块 |

### 后端目录
| 目录 | 说明 |
|------|------|
| `app/adminapi/controller/` | 管理后台接口 |
| `app/api/controller/` | 客户端接口 |
| `app/service/admin/` | 管理后台业务逻辑 |
| `app/service/api/` | 客户端业务逻辑 |
| `app/model/` | 数据模型 |

## 测试账号

### 管理后台
- **地址**: `http://localhost:23000`
- **用户名**: `admin`
- **密码**: `123123`

## 开发规范

### 新增功能流程
1. 后端：控制器 → Service → Model
2. 前端：API → 页面组件
3. 路由：注册新页面路由

### 文件命名
- 控制器：`Xxx.php`
- Service：`XxxService.php`
- Model：`Xxx.php`
- 页面：`.vue`

## 相关项目

- **钜惠云仓商城项目**: `/Users/mac/coding/juhuiyuncang/juhuiyuncloudadmin`
- **数据采集项目**: `/Users/mac/coding/juhuiyuncang/datahandle`
- **物流项目**: `/Users/mac/coding/juhuiyuncang/groupeddelivery`