first commit

frontend/DEBUG_GUIDE.md

@@ -0,0 +1,118 @@
+# 前端接口调试指南
+
+## 问题诊断步骤
+
+### 1. 打开浏览器开发者工具
+- 按 F12 或右键 → 检查
+- 切换到 **Console（控制台）** 标签
+- 切换到 **Network（网络）** 标签
+
+### 2. 查看控制台错误
+在控制台查看具体的错误信息，常见错误：
+
+#### 错误类型 1: CORS 错误
+```
+Access to XMLHttpRequest at 'http://localhost:8000/api/v1/...' 
+from origin 'http://localhost:5173' has been blocked by CORS policy
+```
+**解决方法**: 这是正常的，说明请求到达了后端，检查后端 CORS 配置
+
+#### 错误类型 2: 404 Not Found
+```
+GET http://localhost:5173/api/v1/departments 404 (Not Found)
+```
+**原因**: Vite 代理配置问题
+**解决方法**: 重启前端开发服务器
+
+#### 错误类型 3: 500 Internal Server Error
+```
+POST http://localhost:8000/api/v1/auth/login 500 (Internal Server Error)
+```
+**原因**: 后端服务错误
+**解决方法**: 检查后端日志 `backend/logs/error_*.log`
+
+#### 错误类型 4: Network Error
+```
+Error: Network Error
+```
+**原因**: 后端服务未运行
+**解决方法**: 启动后端服务 `cd backend && uvicorn app.main:app --reload`
+
+### 3. 查看网络请求
+
+在 Network 标签中：
+1. 找到失败的请求（红色）
+2. 点击请求查看详情
+3. 查看 **Response（响应）** 标签，查看后端返回的错误信息
+
+### 4. 常见接口错误及解决
+
+#### 登录失败
+**检查点**:
+- 后端是否运行：访问 http://localhost:8000/health
+- 账号密码是否正确：admin / admin123
+- Content-Type 是否为 `application/x-www-form-urlencoded`
+
+#### 科室/员工/指标列表失败
+**检查点**:
+- 是否已登录获取 token
+- token 是否过期
+- 请求头是否包含 `Authorization: Bearer {token}`
+
+#### 统计报表失败
+**检查点**:
+- 参数是否正确（period_year, period_month）
+- 数据库中是否有对应数据
+
+### 5. 快速测试工具
+
+访问 http://localhost:5173/test-api.html 使用内置的 API 测试工具
+
+### 6. 清除缓存
+
+如果遇到问题：
+1. 清除浏览器缓存：Ctrl+Shift+Delete
+2. 清除 localStorage:
+   ```javascript
+   localStorage.clear()
+   ```
+3. 硬刷新：Ctrl+F5
+
+### 7. 重启服务
+
+如果以上都无效：
+```bash
+# 停止所有 Python 进程
+powershell -Command "Get-Process | Where-Object {$_.ProcessName -eq 'python'} | Stop-Process -Force"
+
+# 重启后端
+cd D:\医院绩效系统\backend
+python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
+
+# 重启前端（新终端）
+cd D:\医院绩效系统\frontend
+npm run dev
+```
+
+## 当前系统状态
+
+### 后端状态
+- 地址：http://localhost:8000
+- 健康检查：http://localhost:8000/health
+- API 文档：http://localhost:8000/api/v1/docs
+- 日志目录：`backend/logs/`
+
+### 前端状态
+- 地址：http://localhost:5173
+- Vite 配置：代理 `/api` 到 `http://localhost:8000`
+
+### 默认账号
+- 用户名：admin
+- 密码：admin123
+
+## 联系支持
+
+如果问题仍未解决，请提供：
+1. 控制台错误截图
+2. Network 标签中失败请求的详情
+3. 后端日志内容