yunhaifinance/docs/采购付款分离改造方案.md

ERP系统改造方案：采购申请与付款申请分离

📋 项目背景

当前问题：

• 付款申请混合了公司运营支出和项目材料采购
• 项目成本统计不精确
• 库存管理无法关联采购流程
• 商品管理已存在但缺少库存管理

改造目标：

• 建立独立的采购申请流程（项目材料/设备）
• 简化付款申请流程（公司运营支出）
• 实现项目成本精确统计
• 建立基础库存管理

---

🗂️ 改造范围

1. 数据库层

• 新增采购申请表
• 新增采购明细表
• 新增库存记录表
• 修改付款申请表（简化）
• 新增项目成本统计视图

2. 后端API层

• 采购申请CRUD API
• 采购审批流程API
• 库存管理API
• 项目成本统计API
• 付款申请简化API

3. 前端页面层

• 采购申请管理页面
• 采购申请审批页面
• 库存管理页面
• 项目成本统计页面
• 简化付款申请页面

---

🧪 TDD测试策略

测试层级

1. 单元测试 (Unit Tests)
   - 数据库模型测试
   - API接口测试
   - 业务逻辑测试

2. 集成测试 (Integration Tests)
   - 采购-库存-项目流程测试
   - 审批流程测试

3. 端到端测试 (E2E Tests)
   - 完整业务流程测试
   - 用户场景测试

---

📊 数据库设计

新表1：采购申请表 (purchase_requests)

CREATE TABLE purchase_requests (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  request_code TEXT UNIQUE NOT NULL,      -- 采购申请编号：PUR-20240324-001
  project_id INTEGER NOT NULL,             -- 关联项目（必填）
  applicant TEXT NOT NULL,                 -- 申请人
  request_date DATE NOT NULL,              -- 申请日期
  supplier_id INTEGER,                     -- 供应商ID（从供应商库选择）
  supplier_name TEXT,                      -- 供应商名称（手动输入或库中选择）
  expense_category TEXT NOT NULL,          -- 支出分类：material/equipment/pole/other
  total_amount REAL NOT NULL DEFAULT 0,    -- 总金额
  currency TEXT DEFAULT 'CNY',             -- 币种
  status TEXT DEFAULT 'pending',           -- 状态：pending/approved/rejected/executed
  remark TEXT,                             -- 备注
  attachments TEXT,                        -- 附件JSON数组
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  FOREIGN KEY (project_id) REFERENCES projects(id),
  FOREIGN KEY (supplier_id) REFERENCES suppliers(id)
);

新表2：采购明细表 (purchase_request_items)

CREATE TABLE purchase_request_items (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  purchase_request_id INTEGER NOT NULL,    -- 关联采购申请
  product_id INTEGER,                      -- 商品ID（从商品库选择）
  product_name TEXT NOT NULL,              -- 商品名称
  specification TEXT,                      -- 规格型号
  unit TEXT,                               -- 单位
  quantity REAL NOT NULL DEFAULT 0,        -- 数量
  unit_price REAL NOT NULL DEFAULT 0,      -- 单价
  total_price REAL NOT NULL DEFAULT 0,     -- 小计
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  FOREIGN KEY (purchase_request_id) REFERENCES purchase_requests(id) ON DELETE CASCADE,
  FOREIGN KEY (product_id) REFERENCES products(id)
);

新表3：库存记录表 (inventory_records)

CREATE TABLE inventory_records (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  record_type TEXT NOT NULL,               -- 记录类型：in(入库)/out(出库)
  project_id INTEGER,                      -- 关联项目（出库时必填）
  purchase_request_id INTEGER,             -- 关联采购申请（入库时）
  product_id INTEGER NOT NULL,             -- 商品ID
  quantity REAL NOT NULL DEFAULT 0,        -- 数量（正数）
  unit_price REAL,                         -- 单价
  total_amount REAL,                       -- 总金额
  record_date DATE NOT NULL,               -- 记录日期
  operator TEXT,                           -- 操作人
  remark TEXT,                             -- 备注
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  FOREIGN KEY (project_id) REFERENCES projects(id),
  FOREIGN KEY (purchase_request_id) REFERENCES purchase_requests(id),
  FOREIGN KEY (product_id) REFERENCES products(id)
);

修改表：付款申请表 (payment_requests) - 简化

-- 保留字段：
-- id, request_code, applicant, payment_date, payee, bank_account, bank_name
-- amount, currency, reason, status, attachments, created_at, updated_at

-- 移除字段：
-- detail_items（不再需要明细）

-- 保留但限制使用范围的字段：
-- expense_type: 只允许 'company'（公司支出）
-- expense_category: 只允许公司支出分类
-- payee_type, payee_id: 保留
-- project_id: 可选，用于关联项目但非采购类支出

---

🔄 业务流程设计

流程1：采购申请流程

1. 创建采购申请
   ↓
2. 选择项目（必填）
   ↓
3. 添加商品明细（从商品库选择）
   ↓
4. 选择供应商（从供应商库或手动输入）
   ↓
5. 提交审批
   ↓
6. 审批通过 → 生成采购单
   ↓
7. 货物到货 → 入库操作 → 自动更新库存
   ↓
8. 项目成本自动统计

流程2：付款申请流程（简化）

1. 创建付款申请
   ↓
2. 选择付款类型：
   - 公司运营支出（房租/工资/营销等）
   - 项目其他支出（非采购类）
   - 采购尾款（关联采购单）
   ↓
3. 填写金额和收款信息
   ↓
4. 提交审批
   ↓
5. 审批通过 → 执行付款

---

📱 页面设计

页面1：采购申请管理

功能：

• 采购申请列表（按项目筛选）
• 新建采购申请
• 编辑/删除（待审批状态）
• 查看详情
• 提交审批

表单字段：

- 申请日期
- 关联项目（下拉选择）
- 供应商（二级：从库选择/手动输入）
- 支出分类（材料/设备/电杆/其他）
- 商品明细（多行，从商品库选择）
- 总金额（自动计算）
- 币种
- 附件
- 备注

页面2：采购申请审批

功能：

• 待审批列表
• 审批通过/驳回
• 查看详情（含商品明细）

页面3：库存管理

功能：

• 库存查询（按商品、按项目）
• 入库记录（采购自动入库）
• 出库记录（项目领用）
• 库存预警

页面4：项目成本统计

功能：

• 项目列表
• 项目详情页：
  • 合同金额
  • 采购成本（材料/设备/电杆等分类统计）
  • 付款支出（非采购类）
  • 人工成本（预留）
  • 利润计算

页面5：付款申请（简化版）

功能：

• 付款申请列表
• 新建付款申请（简化表单）
• 审批流程

简化表单字段：

- 付款日期
- 付款类型（公司支出/项目其他支出/采购尾款）
- 收款单位（简化选择）
- 金额
- 付款事由
- 关联项目（可选）
- 关联采购单（付款类型为采购尾款时）
- 附件

---

🧪 TDD测试计划

阶段1：数据库层测试（第1-2天）

测试文件：

• test-purchase-requests-table.spec.js
• test-purchase-request-items-table.spec.js
• test-inventory-records-table.spec.js

测试内容：

// 示例测试
describe('采购申请表', () => {
  test('应该能创建采购申请', async () => {
    const result = await db.query(
      'INSERT INTO purchase_requests (...) VALUES (...)'
    );
    expect(result.changes).toBe(1);
  });
  
  test('采购申请编号应该唯一', async () => {
    // 测试唯一约束
  });
  
  test('应该能关联项目和供应商', async () => {
    // 测试外键约束
  });
});

阶段2：后端API测试（第3-5天）

测试文件：

• test-purchase-requests-api.spec.js
• test-inventory-api.spec.js
• test-project-cost-api.spec.js

测试内容：

// 示例测试
describe('采购申请API', () => {
  test('POST /api/purchase-requests - 创建采购申请', async () => {
    const response = await request(app)
      .post('/api/purchase-requests')
      .send({...});
    expect(response.status).toBe(200);
    expect(response.body.success).toBe(true);
  });
  
  test('应该能计算采购总金额', async () => {
    // 测试金额计算逻辑
  });
  
  test('审批通过后应该能入库', async () => {
    // 测试审批-入库流程
  });
});

阶段3：前端页面测试（第6-8天）

测试文件：

• test-purchase-requests-page.spec.js
• test-inventory-page.spec.js
• test-project-cost-page.spec.js

测试内容：

// 示例测试
describe('采购申请页面', () => {
  test('应该能显示采购申请列表', async () => {
    // 测试页面渲染
  });
  
  test('应该能从商品库选择商品', async () => {
    // 测试商品选择功能
  });
  
  test('应该能自动计算总金额', async () => {
    // 测试金额计算
  });
});

阶段4：集成测试（第9-10天）

测试场景：

1. 完整采购流程：申请→审批→入库→成本统计
2. 付款申请流程：创建→审批→执行
3. 项目成本统计：多笔采购+付款的汇总

---

📅 实施计划（10天）

第1天：备份与准备

• 备份现有数据库
• 备份现有代码
• 创建新分支
• 编写数据库迁移脚本

第2天：数据库层

• 创建采购申请表
• 创建采购明细表
• 创建库存记录表
• 修改付款申请表
• 编写数据库测试

第3-4天：后端API - 采购申请

• 采购申请CRUD API
• 采购审批流程API
• 采购明细API
• 编写API测试

第5天：后端API - 库存与统计

• 库存管理API
• 项目成本统计API
• 修改付款申请API（简化）
• 编写API测试

第6天：前端 - 采购申请页面

• 采购申请列表页
• 采购申请表单（含商品选择）
• 采购申请详情页

第7天：前端 - 审批与库存

• 采购审批页面
• 库存管理页面
• 入库/出库操作

第8天：前端 - 统计与付款

• 项目成本统计页面
• 简化付款申请页面
• 修改现有付款申请页面

第9天：集成测试

• 完整流程测试
• Bug修复
• 性能优化

第10天：验收与部署

• 最终测试
• 用户验收
• 部署上线

---

📦 交付物清单

1. 数据库

• 迁移脚本
• 表结构文档
• 测试数据

2. 后端

• 采购申请API
• 库存管理API
• 项目统计API
• 测试用例（覆盖率>80%）

3. 前端

• 采购申请管理页面
• 采购审批页面
• 库存管理页面
• 项目成本统计页面
• 简化付款申请页面

4. 文档

• API文档
• 用户操作手册
• 测试报告

---

⚠️ 风险评估

风险	影响	应对措施
数据迁移失败	高	完整备份，分步迁移，验证数据
商品库不完善	中	允许手动输入商品名称，后续完善商品库
用户不适应新流程	中	保留旧付款申请一段时间，并行使用
项目统计不准确	高	增加数据校验，提供手动调整功能

---

✅ 验收标准

1. 功能验收

   • 能正常创建采购申请
   • 能从商品库选择商品
   • 审批流程正常
   • 入库后库存正确更新
   • 项目成本统计准确

2. 性能验收

   • 页面加载<2秒
   • 列表查询<1秒
   • 报表生成<3秒

3. 测试验收

   • 单元测试通过率100%
   • 集成测试通过率100%
   • 无严重Bug

---

📝 变更记录

日期	版本	变更内容	变更人
2026-03-24	v1.0	初始方案	AI Assistant

---

方案状态： 已保存，待执行 备份状态： 待备份 开始日期： 待定