瑜伽学员课时管理系统
这是一个为瑜伽老师设计的轻量级学员管理工具，使用 SQLite 本地数据库存储，支持：
- 学员基本信息管理（姓名、电话、微信、备注）
- 多种课程类型：线上课 / 线下课
- 两种套餐模式：包年 / 包课时
- 包课时课程自动扣除课时并记录日志
- 每次扣除后自动发送邮件记录给自己
- 手动发送完整学员报表
首次配置
安装后必须先配置邮箱，否则无法发送课时记录邮件。
使用交互式配置：
from config import prompt_email_config
prompt_email_config()
或手动配置：
from config import set_email_config
set_email_config(
smtp_server="smtp.qq.com",
smtp_port=587,
email="your_email@qq.com",
password="your_auth_code",
use_ssl=True
)
常用邮箱SMTP设置参考：
- Gmail:
smtp.gmail.com, 端口587（需开启应用专用密码） - QQ邮箱:
smtp.qq.com, 端口587（需使用授权码而非登录密码） - 163邮箱:
smtp.163.com, 端口25 - Outlook:
smtp.office365.com, 端口587
命令行使用
运行主程序：
python main.py
首次运行会提示配置邮箱。之后进入交互式菜单：
- 添加学员
- 查看所有学员
- 查看学员详情
- 修改学员信息
- 删除学员
- 添加课程
- 扣除课时
- 增加课时
- 查看扣除记录
- 发送完整报表
- 配置邮箱
- 退出
Python API 使用
from manager import YogaManager
manager = YogaManager()
# 添加学员
sid = manager.add_student("张三", phone="13800138000", wechat="zhangsan123")
# 添加包课时课程（线下课，50课时）
cid = manager.add_course(
student_id=sid,
course_type="offline", # 或 "online"
package_type="hourly", # 或 "yearly"
total_hours=50,
remaining_hours=50,
price=5000.00
)
# 扣除课时（每次上完课调用）
result = manager.deduct_hours(course_id=cid, hours=1, notes="哈他瑜伽基础课")
# 扣除成功后会自动发送邮件记录
# 添加包年课程
manager.add_course(
student_id=sid,
course_type="online",
package_type="yearly",
start_date="2026-01-01",
end_date="2026-12-31",
price=8000.00
)
# 查看学员详情
manager.show_student(sid)
# 发送完整报表
manager.send_full_report()
数据库结构
SQLite 数据库文件：yoga_students.db
students 表 - 学员基本信息
| 字段 | 类型 | 说明 |
|---|---|---|
| id | INTEGER | 主键 |
| name | TEXT | 姓名 |
| phone | TEXT | 电话 |
| TEXT | 微信 | |
| notes | TEXT | 备注 |
| created_at | TEXT | 创建时间 |
student_courses 表 - 学员课程信息
| 字段 | 类型 | 说明 |
|---|---|---|
| id | INTEGER | 主键 |
| student_id | INTEGER | 学员ID（外键） |
| course_type | TEXT | online/offline |
| package_type | TEXT | yearly/hourly |
| total_hours | INTEGER | 总课时（包课时） |
| remaining_hours | INTEGER | 剩余课时（包课时） |
| start_date | TEXT | 开始日期（包年） |
| end_date | TEXT | 结束日期（包年） |
| price | REAL | 价格 |
deduction_logs 表 - 课时扣除日志
| 字段 | 类型 | 说明 |
|---|---|---|
| id | INTEGER | 主键 |
| student_id | INTEGER | 学员ID |
| course_id | INTEGER | 课程ID |
| deducted_hours | INTEGER | 扣除课时数 |
| remaining_before | INTEGER | 扣除前剩余 |
| remaining_after | INTEGER | 扣除后剩余 |
| class_date | TEXT | 上课日期 |
| notes | TEXT | 备注 |
| created_at | TEXT | 记录时间 |
文件结构
yoga_student_manager/
├── SKILL.md # 本说明文件
├── main.py # 命令行入口
├── manager.py # 核心管理类
├── database.py # 数据库模型
├── email_sender.py # 邮件发送模块
├── config.py # 配置管理
├── yoga_students.db # SQLite数据库（自动创建）
└── config.json # 邮箱配置（自动创建）