4.1 KiB
4.1 KiB
问题清单 - 进销存系统
创建日期: 2026-03-09
最后更新: 2026-03-09 19:10 UTC
🔴 高优先级（阻塞）
ISSUE-001: 缺失页面组件导致运行时错误
状态: 🟐 待修复
分配给: @frontend-team
影响范围: 所有非仪表盘页面
问题描述: App.tsx 导入了 5 个不存在的页面组件，用户点击菜单项会导致应用崩溃。
缺失文件:
src/pages/projects/ProjectsPage.tsxsrc/pages/advances/AdvancesPage.tsxsrc/pages/reimbursements/ReimbursementsPage.tsxsrc/pages/finance/FinancePage.tsxsrc/pages/reports/ReportsPage.tsx
修复方案:
- 创建空壳组件（临时方案）
- 逐步实现业务逻辑
验收标准:
- 所有菜单项点击不报错
- 页面显示"开发中"提示
- 控制台无错误
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.pngpublic/pwa-512x512.pngpublic/apple-touch-icon.pngpublic/favicon.ico
修复方案: 使用 PWA Asset Generator 生成图标：
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)，不适合生产环境。
修复方案:
- 执行
npm run build构建生产版本 - 使用 Nginx 或其他 Web 服务器托管 dist 目录
- 配置反向代理到后端 API
验收标准:
- 构建无错误
- 生产版本可正常访问
- 性能优化（压缩、缓存等）
📝 问题状态图例
| 状态 | 图标 | 说明 |
|---|---|---|
| 待修复 | 🟐 | 尚未开始处理 |
| 进行中 | 🔵 | 正在修复 |
| 待验证 | 🟣 | 修复完成，等待测试 |
| 已解决 | ✅ | 测试通过 |
| 预期行为 | ℹ️ | 无需修复 |
| 已关闭 | ⚫ | 已归档 |
📊 统计
- 高优先级: 2 个（阻塞功能）
- 中优先级: 2 个（影响体验）
- 低优先级: 2 个（优化建议）
- 总计: 6 个
维护说明:
- 修复问题后更新状态
- 新问题按格式添加
- 每周回顾问题清单