zhjwxt/PROJECT.md

智慧教务系统

项目概述

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

项目结构

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

启动命令

# 启动所有服务 (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