交互式透明化宿舍报修系统

课程项目 —— 带 AI 诊断引导的宿舍报修流程。

快速开始

./cli.py setup           # 安装依赖
./cli.py env             # 创建 .env（可选，未配置 DeepSeek 则使用关键词诊断）
./cli.py start           # 启动前后端

常用命令

./cli.py start           # 启动服务
./cli.py stop            # 停止服务
./cli.py status          # 查看状态
./cli.py logs backend -f # 实时日志
./cli.py seed            # 写入演示数据
./cli.py docker up       # Docker 部署

服务地址

服务	地址
前端	http://127.0.0.1:5173
后端 API	http://127.0.0.1:8000
API 文档	http://127.0.0.1:8000/docs

演示账号

运行 ./cli.py seed 写入演示数据：

角色	用户名	密码
学生	student01	Student123
管理员	admin01	Admin123

环境变量

./cli.py env 会从 .env.example 复制模板。主要配置项见 backend/.env.example。

关键变量：DEEPSEEK_API_KEY — 配置后启用 AI 诊断，留空则降级为关键词匹配。

主流程

1. 学生用自然语言描述故障 → AI/关键词诊断追问 → 生成结构化草稿 → 确认提交
2. 管理员审核工单、分配人员、更新状态
3. 学生确认完工并评价

技术栈

后端  FastAPI + SQLite + DeepSeek API
前端  Vue 3 + Element Plus + Vite
管理  ./cli.py 统一入口 | Docker Compose 可选