# 问题清单 - 进销存系统

**创建日期**: 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 个

---

**维护说明**:
- 修复问题后更新状态
- 新问题按格式添加
- 每周回顾问题清单
