175 lines
4.1 KiB
Markdown
175 lines
4.1 KiB
Markdown
# 问题清单 - 进销存系统
|
||
|
||
**创建日期**: 2026-03-09
|
||
**最后更新**: 2026-03-09 19:10 UTC
|
||
|
||
---
|
||
|
||
## 🔴 高优先级（阻塞）
|
||
|
||
### ISSUE-001: 缺失页面组件导致运行时错误
|
||
|
||
**状态**: 🟐 待修复
|
||
**分配给**: @frontend-team
|
||
**影响范围**: 所有非仪表盘页面
|
||
|
||
**问题描述**:
|
||
App.tsx 导入了 5 个不存在的页面组件，用户点击菜单项会导致应用崩溃。
|
||
|
||
**缺失文件**:
|
||
- [ ] `src/pages/projects/ProjectsPage.tsx`
|
||
- [ ] `src/pages/advances/AdvancesPage.tsx`
|
||
- [ ] `src/pages/reimbursements/ReimbursementsPage.tsx`
|
||
- [ ] `src/pages/finance/FinancePage.tsx`
|
||
- [ ] `src/pages/reports/ReportsPage.tsx`
|
||
|
||
**修复方案**:
|
||
1. 创建空壳组件（临时方案）
|
||
2. 逐步实现业务逻辑
|
||
|
||
**验收标准**:
|
||
- [ ] 所有菜单项点击不报错
|
||
- [ ] 页面显示"开发中"提示
|
||
- [ ] 控制台无错误
|
||
|
||
---
|
||
|
||
### ISSUE-002: API 服务层缺失
|
||
|
||
**状态**: 🟐 待修复
|
||
**分配给**: @frontend-team + @backend-team
|
||
**影响范围**: 所有数据交互功能
|
||
|
||
**问题描述**:
|
||
`src/api/` 目录为空，无法与后端通信。
|
||
|
||
**需要创建**:
|
||
- [ ] `src/api/index.ts` - Axios 实例配置
|
||
- [ ] `src/api/auth.ts` - 认证接口
|
||
- [ ] `src/api/projects.ts` - 项目管理接口
|
||
- [ ] `src/api/advances.ts` - 预支管理接口
|
||
- [ ] `src/api/reimbursements.ts` - 报销管理接口
|
||
- [ ] `src/api/finance.ts` - 财务管理接口
|
||
- [ ] `src/api/reports.ts` - 报表分析接口
|
||
|
||
**验收标准**:
|
||
- [ ] API 客户端可正常调用
|
||
- [ ] 错误处理完善
|
||
- [ ] 支持请求/响应拦截
|
||
|
||
---
|
||
|
||
## 🟡 中优先级（体验）
|
||
|
||
### ISSUE-003: PWA 图标文件缺失
|
||
|
||
**状态**: 🟐 待修复
|
||
**分配给**: @frontend-team
|
||
**影响范围**: 移动端用户体验
|
||
|
||
**问题描述**:
|
||
vite.config.ts 配置了 PWA，但 public 目录缺少必要的图标文件。
|
||
|
||
**缺失文件**:
|
||
- [ ] `public/pwa-192x192.png`
|
||
- [ ] `public/pwa-512x512.png`
|
||
- [ ] `public/apple-touch-icon.png`
|
||
- [ ] `public/favicon.ico`
|
||
|
||
**修复方案**:
|
||
使用 PWA Asset Generator 生成图标：
|
||
```bash
|
||
npx pwa-asset-generator src/assets/logo.svg public
|
||
```
|
||
|
||
**验收标准**:
|
||
- [ ] 所有图标文件存在
|
||
- [ ] 移动端可添加到主屏幕
|
||
- [ ] 图标显示正常
|
||
|
||
---
|
||
|
||
### ISSUE-004: 移动端适配待完善
|
||
|
||
**状态**: 🟐 待测试
|
||
**分配给**: @frontend-team
|
||
**影响范围**: 移动端用户体验
|
||
|
||
**需要测试**:
|
||
- [ ] 侧边栏在移动端自动折叠
|
||
- [ ] 表格支持横向滚动
|
||
- [ ] 按钮和表单元素触摸友好
|
||
- [ ] 字体大小适配小屏幕
|
||
|
||
**验收标准**:
|
||
- [ ] iPhone SE (375px) 显示正常
|
||
- [ ] iPad (768px) 显示正常
|
||
- [ ] 无横向滚动条（除表格外）
|
||
|
||
---
|
||
|
||
## 🟢 低优先级（优化）
|
||
|
||
### ISSUE-005: 公网访问未开放
|
||
|
||
**状态**: ℹ️ 预期行为
|
||
**分配给**: @devops-team
|
||
**影响范围**: 无（使用 Tailscale）
|
||
|
||
**说明**:
|
||
安全组未开放 3001 端口，这是**正确的安全配置**。生产环境应仅允许 Tailscale 内网访问。
|
||
|
||
**建议**:
|
||
- [ ] 文档中明确说明访问方式
|
||
- [ ] 无需修复
|
||
|
||
---
|
||
|
||
### ISSUE-006: 使用开发服务器
|
||
|
||
**状态**: 🟐 待优化
|
||
**分配给**: @devops-team
|
||
**影响范围**: 生产环境部署
|
||
|
||
**问题描述**:
|
||
当前使用 Vite 开发服务器 (`vite --host`)，不适合生产环境。
|
||
|
||
**修复方案**:
|
||
1. 执行 `npm run build` 构建生产版本
|
||
2. 使用 Nginx 或其他 Web 服务器托管 dist 目录
|
||
3. 配置反向代理到后端 API
|
||
|
||
**验收标准**:
|
||
- [ ] 构建无错误
|
||
- [ ] 生产版本可正常访问
|
||
- [ ] 性能优化（压缩、缓存等）
|
||
|
||
---
|
||
|
||
## 📝 问题状态图例
|
||
|
||
| 状态 | 图标 | 说明 |
|
||
|------|------|------|
|
||
| 待修复 | 🟐 | 尚未开始处理 |
|
||
| 进行中 | 🔵 | 正在修复 |
|
||
| 待验证 | 🟣 | 修复完成，等待测试 |
|
||
| 已解决 | ✅ | 测试通过 |
|
||
| 预期行为 | ℹ️ | 无需修复 |
|
||
| 已关闭 | ⚫ | 已归档 |
|
||
|
||
---
|
||
|
||
## 📊 统计
|
||
|
||
- **高优先级**: 2 个（阻塞功能）
|
||
- **中优先级**: 2 个（影响体验）
|
||
- **低优先级**: 2 个（优化建议）
|
||
- **总计**: 6 个
|
||
|
||
---
|
||
|
||
**维护说明**:
|
||
- 修复问题后更新状态
|
||
- 新问题按格式添加
|
||
- 每周回顾问题清单
|