44 KiB
44 KiB
公司财务ERP系统 - 项目管理大改造设计方案
创建日期：2026-05-14 状态：设计方案已完成，待实施
一、改造目标
- 施工进度与收款彻底分离 —— 两条独立轨道运行
- 工程类型模板系统 —— 不同类型工程有不同施工阶段，支持串/并联
- 施工进度推进简单化 —— 阶段确认 → 勾选完成，不绑定业务数据
- 物资采购全流程 —— 采购申请→审批→订单→物流→现场收货，一条龙
- 分包商事件评分 —— 事件记录加减分，初始100分
- 历史数据批量补录 —— Excel导入 + source字段（统一收支表之后做）
二、导航结构（改造后）
🏠 工作台
📋 项目管理
├── 项目列表
└── 项目详情（7个Tab）
├── 基本信息
├── 合同与收款
├── 分包管理
├── 材料管理（只读汇总）
├── 财务收支
├── 质保金
└── 施工日志
[进入施工管理 →]
💰 商谈报价
├── 商谈列表
├── 新建商谈
└── 商谈详情
🔨 施工管理（独立模块）
├── 施工总览
├── 施工进度（轻量确认台）
└── 施工日志
📝 财务申请
├── 预支申请
├── 付款申请
├── 报销申请
└── 核销申请
✅ 审批管理
├── 待审批
└── 待执行
📊 财务管理
├── 财务概览
├── 项目收支
├── 汇率管理
└── 预支核销状态
🛒 采购管理
├── 商品管理
├── 采购申请
├── 采购订单
├── 付款计划
└── 库存管理
🤝 合作伙伴
├── 供应商管理
├── 分包商管理
├── 客户管理
└── 物流管理
📈 报表分析
⚙️ 后台管理 /admin
├── 用户管理
├── 角色权限
├── 流程管理
├── 工程模板管理 ← 新增
├── 系统日志
├── 数据备份
└── 关于系统
三、数据库改造
3.1 新增表
工程类型模板表
CREATE TABLE project_type_templates (
id SERIAL PRIMARY KEY,
name VARCHAR(100) NOT NULL,
description TEXT,
phases JSONB NOT NULL DEFAULT '[]',
is_system BOOLEAN DEFAULT false,
created_at TIMESTAMP DEFAULT NOW(),
updated_at TIMESTAMP DEFAULT NOW()
);
项目施工阶段表
CREATE TABLE project_phases (
id SERIAL PRIMARY KEY,
project_id INTEGER REFERENCES projects(id) ON DELETE CASCADE,
template_key VARCHAR(50),
phase_name VARCHAR(100) NOT NULL,
phase_order INTEGER NOT NULL,
phase_type VARCHAR(20) DEFAULT 'serial', -- 'serial' 串行 / 'parallel' 并行
depends_on INTEGER[], -- 依赖的阶段ID数组
status VARCHAR(20) DEFAULT 'pending', -- pending/in_progress/completed/skipped
started_at TIMESTAMP,
completed_at TIMESTAMP,
completed_by INTEGER REFERENCES users(id),
remark TEXT,
photos TEXT[],
sub_items JSONB DEFAULT '[]', -- 子项列表
created_at TIMESTAMP DEFAULT NOW()
);
物流单表（代码已引用但表不存在！）
CREATE TABLE logistics_records (
id SERIAL PRIMARY KEY,
code VARCHAR(50) UNIQUE NOT NULL,
purchase_order_id INTEGER REFERENCES purchase_orders(id),
ship_from VARCHAR(100) DEFAULT 'China',
logistics_company_id INTEGER REFERENCES logistics_companies(id),
logistics_company VARCHAR(200),
tracking_number VARCHAR(100),
ship_date DATE,
ship_location VARCHAR(200),
estimated_arrival_date DATE, -- 预计送达日期
customs_arrival_date DATE, -- 到海关日期
customs_clearance_date DATE, -- 清关完成日期
use_hub BOOLEAN DEFAULT false, -- 是否需要中转仓
hub_arrival_date DATE, -- 到达中转仓日期
hub_receiver VARCHAR(100),
hub_verified_quantity BOOLEAN DEFAULT false,
second_ship_date DATE, -- 二次运输发车日期
primary_freight NUMERIC(15,2) DEFAULT 0, -- 头程运费（中国→老挝）
primary_freight_currency VARCHAR(10) DEFAULT 'CNY',
primary_freight_status VARCHAR(20) DEFAULT 'pending',
primary_freight_document TEXT,
secondary_freight NUMERIC(15,2) DEFAULT 0, -- 二次运费（到现场）
secondary_freight_currency VARCHAR(10) DEFAULT 'LAK',
secondary_freight_status VARCHAR(20) DEFAULT 'pending',
driver_phone VARCHAR(50),
cargo_weight NUMERIC(15,2),
transport_distance NUMERIC(15,2),
final_arrival_date DATE, -- 最终到达现场日期
final_location VARCHAR(200), -- 最终收货地点
status VARCHAR(20) DEFAULT 'pending', -- pending/in_transit/at_customs/at_hub/secondary/arrived
remark TEXT,
created_by INTEGER REFERENCES users(id),
created_at TIMESTAMP DEFAULT NOW(),
updated_at TIMESTAMP DEFAULT NOW()
);
现场收货确认表
CREATE TABLE receiving_confirms (
id SERIAL PRIMARY KEY,
purchase_order_id INTEGER REFERENCES purchase_orders(id),
logistics_record_id INTEGER REFERENCES logistics_records(id),
confirm_date DATE DEFAULT CURRENT_DATE,
receiver_name VARCHAR(100), -- 收货人
receiver_phone VARCHAR(50),
received_location VARCHAR(200), -- 收货地点
is_complete BOOLEAN DEFAULT true, -- 是否全部到齐
missing_items TEXT, -- 缺失项描述
damage_items TEXT, -- 损坏项描述
photo_urls TEXT[], -- 收货照片
remark TEXT,
confirmed_by INTEGER REFERENCES users(id),
created_at TIMESTAMP DEFAULT NOW()
);
分包商事件记录表
CREATE TABLE subcontractor_events (
id SERIAL PRIMARY KEY,
subcontractor_id INTEGER REFERENCES subcontractors(id),
project_id INTEGER REFERENCES projects(id),
event_type VARCHAR(10) NOT NULL, -- 'positive' / 'negative'
score_change INTEGER NOT NULL, -- 1~10 或 -10~-1
event_date DATE NOT NULL,
title VARCHAR(200) NOT NULL,
description TEXT,
created_by INTEGER REFERENCES users(id),
created_at TIMESTAMP DEFAULT NOW()
);
3.2 修改现有表
projects 表增加字段
ALTER TABLE projects ADD COLUMN type_template_id INTEGER;
ALTER TABLE projects ADD COLUMN current_phase VARCHAR(50);
ALTER TABLE projects ADD COLUMN phase_progress NUMERIC(5,2) DEFAULT 0;
purchase_orders 表增加字段
ALTER TABLE purchase_orders ADD COLUMN expected_delivery_date DATE;
ALTER TABLE purchase_orders ADD COLUMN receiving_status VARCHAR(20) DEFAULT 'pending';
-- receiving_status: pending/partial_received/received/verified
subcontractors 表增加字段
ALTER TABLE subcontractors ADD COLUMN score INTEGER DEFAULT 100;
ALTER TABLE subcontractors ADD COLUMN initial_score INTEGER DEFAULT 100;
四、物资采购完整流程
4.1 流程图
采购申请（选择项目、供应商、商品明细）
│
↓ 提交审批
│
审批管理 → 审批通过
│
↓ 生成采购订单
│
采购订单（确认商品、数量、价格）
│
↓ 创建物流单
│
物流单（选择物流公司、预计送达日期）
├─ 头程运输：中国仓库 → 老挝海关 → 中转仓
│ 填写：发货日期、预计到海关日期、清关日期
│ 填写：头程运费
│
├─ 中转仓（可选）
│ 填写：到达中转仓日期、验货数量
│
├─ 二次运输：中转仓 → 项目现场
│ 填写：发车日期、司机电话、运费
│ 填写：预计到达现场日期
│
└─ 现场收货确认
拍照、检查数量质量、确认到齐/缺失/损坏
│
↓ 确认收货
│
库存记录更新（入库 → 项目库存）
│
↓
项目详情 → 材料管理Tab（自动汇总显示）
4.2 页面结构
采购订单详情页（多Tab布局）
┌─────────────────────────────────────────────────────────┐
│ 采购订单详情 PO202605140001 状态：已确认 │
├─────────────────────────────────────────────────────────┤
│ [基本信息] [商品明细] [物流信息] [验收记录] [付款计划] │
│ │
│ ┌─ 基本信息 ───────────────────────────────────────┐ │
│ │ 订单编号：PO202605140001 │ │
│ │ 所属项目：老挝川圹22kV项目 │ │
│ │ 供应商： XX电气设备公司 │ │
│ │ 预计送达：[2025-03-15 ] │ │
│ │ 收货状态：⏳待收货 │ │
│ │ │ │
│ │ [确认订单] [取消订单] │ │
│ └────────────────────────────────────────────────────┘ │
│ │
│ ┌─ 物流信息 ───────────────────────────────────────┐ │
│ │ 物流单号：LR202605140001 │ │
│ │ 物流公司：[XX国际物流 ▼] │ │
│ │ │ │
│ │ 头程运输（中国→老挝）： │ │
│ │ 发货地： [云南昆明 ] │ │
│ │ 发货日期：[2025-02-20 ] │ │
│ │ 预计到海关：[2025-02-25 ] │ │
│ │ 清关日期：[2025-03-01 ] │ │
│ │ 头程运费：[8,000] CNY │ │
│ │ │ │
│ │ ☐ 需要中转仓 │ │
│ │ 到达中转仓：[2025-03-02 ] │ │
│ │ 中转仓验货：[数量无误 ☑] │ │
│ │ │ │
│ │ 二次运输（中转仓→现场）： │ │
│ │ 发车日期：[2025-03-03 ] │ │
│ │ 司机电话：[020 12345678 ] │ │
│ │ 二次运费：[1,500,000] LAK │ │
│ │ 预计到达现场：[2025-03-05] │ │
│ │ │ │
│ │ [更新物流信息] │ │
│ └────────────────────────────────────────────────────┘ │
│ │
│ ┌─ 验收记录（现场收货确认）────────────────────────┐ │
│ │ 收货日期：[2025-03-05 ] │ │
│ │ 收货人： [张三 ] │ │
│ │ 收货地点：[川圹省项目现场 ] │ │
│ │ │ │
│ │ 收货状态：● 全部到齐 ○ 部分到齐 ○ 未到货 │ │
│ │ │ │
│ │ 缺失项：（选填） │ │
│ │ ┌─────────────────────────────────────────────┐ │ │
│ │ │ 缺少绝缘子50个 │ │ │
│ │ └─────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ 损坏项：（选填） │ │
│ │ ┌─────────────────────────────────────────────┐ │ │
│ │ │ 无 │ │ │
│ │ └─────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ 📷 收货照片： │ │
│ │ [📷] [📷] [+上传] │ │
│ │ │ │
│ │ [确认收货] │ │
│ └────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
五、核心页面设计
5.1 项目详情页（7个Tab）
┌─────────────────────────────────────────────────────────┐
│ ← 返回 老挝川圹22kV配电项目 ████████░░ 62% │
├─────────────────────────────────────────────────────────┤
│ [基本信息] [合同与收款] [分包管理] [材料管理] │
│ [财务收支] [质保金] [施工日志] │
│ │
│ 📍 施工进度：设备安装中（4/7阶段） │
│ [进入施工管理 →] │
├─────────────────────────────────────────────────────────┤
│ (Tab内容) │
└─────────────────────────────────────────────────────────┘
Tab1 基本信息：项目基础字段编辑（不变）
Tab2 合同与收款：
- 合同基本信息（合同金额、结算方式、工期、质保金）
- 甲方收款计划（独立于施工进度）
- [编辑合同] [添加收款节点] [标记已收款]
Tab3 分包管理：
- 分包合同列表（分包商、金额、已付款、待付款、状态、分数）
- 点击查看详情 ↓
┌─ 分包详情：李工班组 ────────────────────────────────┐
│ [合同信息] [付款记录] [事件记录] │
│ │
│ 综合评分：96分 ████████████░░░░ 初始分：100 │
│ │
│ 事件记录： │
│ ┌────┬──────┬──────┬─────┬─────────────────┐ │
│ │日期│类型 │分数 │累计 │事件 │ │
│ ├────┼──────┼──────┼─────┼─────────────────┤ │
│ │03-01│⚠️扣分│ -3 │ 97 │电杆基础垂直度不够│ │
│ │02-15│✅加分│ +5 │100 │提前完成土建 │ │
│ │01-20│⚠️扣分│ -5 │ 95 │工人到场迟到3天 │ │
│ │01-01│初始 │起始分│100 │初始分数 │ │
│ └────┴──────┴──────┴─────┴─────────────────┘ │
│ │
│ [+ 添加事件] │
└──────────────────────────────────────────────────────┘
Tab4 材料管理（只读汇总，数据来自采购管理系统）：
┌─ 材料管理 ───────────────────────────────────────────┐
│ [订购汇总] [使用汇总] [退库汇总] │
│ │
│ 数据来自：采购管理→采购订单→物流→收货确认 │
│ │
│ ┌──────┬────┬──────┬──────┬────────┬────────┐ │
│ │材料 │单位│订购量│已到货│供应商 │状态 │ │
│ ├──────┼────┼──────┼──────┼────────┼────────┤ │
│ │电杆 │根 │ 50 │ 50 │XX供应商│✅到齐 │ │
│ │变压器│台 │ 2 │ 2 │YY供应商│✅到齐 │ │
│ │电缆 │米 │ 3000 │ 2500 │ZZ供应商│⏳部分 │ │
│ └──────┴────┴──────┴──────┴────────┴────────┘ │
│ │
│ [去采购管理 →] │
└───────────────────────────────────────────────────────┘
Tab5 财务收支（收支汇总视图）：
- 合同金额、甲方回款、总支出、毛利
- 材料费/人工费/机械费/其他支出 饼图
- 收支明细列表
Tab6 质保金（不变） Tab7 施工日志（不变）
5.2 施工管理 → 施工进度页（手机友好）
┌──────────────────────────┐
│ ← 返回 施工进度 │
│ │
│ 老挝川圹22kV配电项目 │
│ ██████████░░░░░░ 62% │
│ │
│ ①勘察 ②物资 ③土建 ④安装│
│ ✅ ✅ ✅ 🔵 │
│ │
│ 📍 当前：④ 设备安装 │
│ ┌───────────────────────┐ │
│ │ ☑ 变压器就位固定 │ │
│ │ ☐ 配电柜安装接线 │ │
│ │ ☐ 母线桥架安装 │ │
│ │ ☐ 接地系统完成 │ │
│ │ │ │
│ │ 备注：[ ]│ │
│ │ 📷 [拍照] │ │
│ │ │ │
│ │ [✅ 确认完成此阶段] │ │
│ └───────────────────────┘ │
│ │
│ 阶段历史： │
│ ✅ ③土建基础 02-10完成 │
│ ✅ ②物资采购 01-28完成 │
│ ✅ ①勘察设计 01-15完成 │
└──────────────────────────┘
5.3 施工总览页
┌─────────────────────────────────────────────────────────┐
│ 施工总览 2025年2月 │
│ │
│ 施工中：3个 | ⚠️ 延期风险：1个 │
│ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ 🔵 老挝川圹22kV 设备安装(4/7) ██████░░ 57% │ │
│ │ 收款：150K/500K(30%) [进入] │ │
│ ├──────────────────────────────────────────────────┤ │
│ │ 🔵 万象10kV线路 架线施工(5/7) ████████░░ 71% │ │
│ │ 收款：80K/300K(27%) ⚠️延期 [进入] │ │
│ ├──────────────────────────────────────────────────┤ │
│ │ 🟢 琅勃拉邦户表 安装施工(3/5) ██████░░░░ 60% │ │
│ │ 收款：50K/100K(50%) [进入] │ │
│ └──────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
六、工程模板设计器（后台管理）
6.1 页面路径
/admin/process-templates
6.2 模板列表页
┌─────────────────────────────────────────────────────────┐
│ 后台管理 / 工程模板管理 │
├─────────────────────────────────────────────────────────┤
│ │
│ 系统预设模板（不可删除，可复制） │
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ │配电安装│ │架空线路│ │电缆敷设│ │变电站 │ │小型工程│ │
│ │7阶段 │ │7阶段 │ │7阶段 │ │8阶段 │ │5阶段 │ │
│ │[查看] │ │[查看]│ │[查看]│ │[查看]│ │[查看]│ │
│ │[复制] │ │[复制]│ │[复制]│ │[复制]│ │[复制]│ │
│ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │
│ │
│ 自定义模板 │
│ ┌─────────────────────────────────────────────┐ │
│ │ 📋 老挝配电+线路混合 6阶段 [编辑] [删除] │ │
│ └─────────────────────────────────────────────┘ │
│ │
│ [+ 新建模板] │
└─────────────────────────────────────────────────────────┘
6.3 新建/编辑模板
第1步：基本信息
模板名称：[ ]
模板描述：[ ]
第2步：设计阶段
┌─ 阶段列表 ───────────────────────────────────────────────┐
│ │
│ ① 勘察设计 串行 依赖：无 子项：勘察、设计、方案确认 │
│ [编辑] [↑] [↓] [删除] │
│ ──────────────────────────────────────────────────────── │
│ ② 物资采购 并行 依赖：① 子项：电杆、变压器、电缆... │
│ [编辑] [↑] [↓] [删除] │
│ ──────────────────────────────────────────────────────── │
│ ③ 土建基础 串行 依赖：① 子项：开挖、浇筑、接地 │
│ [编辑] [↑] [↓] [删除] │
│ │
│ [+ 添加阶段] │
└───────────────────────────────────────────────────────────┘
点击[编辑]弹出抽屉：
┌──────────────────────────────────────┐
│ 编辑阶段 [×] │
│ │
│ 阶段名称：[物资采购 ] │
│ 阶段类型：○ 串行 ● 并行 │
│ │
│ 依赖关系： │
│ ┌───────────────────────────┐ │
│ │ ☑ ①勘察设计 │ │
│ │ ☐ ③土建基础 │ │
│ └───────────────────────────┘ │
│ │
│ 子项列表： │
│ 1. 电杆采购 [×删除] │
│ 2. 变压器采购 [×删除] │
│ 3. 电缆采购 [×删除] │
│ [+ 添加子项] │
│ │
│ [取消] [保存] │
└──────────────────────────────────────┘
第3步：预览确认
阶段流程图预览：
①勘察设计 ──┬──→ ③土建基础 ──→ ④设备安装 ──→ ...
(串行) │ (串行)
└──→ ②物资采购 ──────────────────┘
(并行)
├ 电杆采购
├ 变压器采购
├ 电缆采购
└ 金具绝缘子采购
[确认创建模板]
七、创建项目流程改造
7.1 从商谈签约导入
商谈项目 → 签约 → 弹出签约窗口
→ 合同信息（不变）
→ 新增：选择工程类型模板 [配电安装 ▼]
→ 确认签约
→ 自动创建 projects 记录
→ 自动从模板复制阶段到 project_phases
7.2 手动新建项目
项目管理 → 新建项目
→ 步骤1：选择工程类型模板
[配电安装] [架空线路] [电缆敷设] [变电站] [小型工程] [自定义]
→ 步骤2：填写基本信息
→ 创建 → 自动从模板复制阶段
八、预算报价导入项目的处理
保留原有流程，增强：
在 budget.js 的 PUT /:id/sign 接口中：
- 签约时要求传入
type_template_id参数 - 签约成功创建 projects 后，自动从模板复制阶段到 project_phases
九、数据补录方案（后续实施）
- 先完成系统改造，统一收支表结构
- 增加
source字段标记数据来源（normal/import/summary） - 设计 Excel 模板批量导入
- 报表按分类汇总，不论来源
十、预设模板数据
模板1：配电安装工程
① 勘察设计（串行）- 无依赖
② 物资采购（并行）- 依赖① - 子项：电杆、变压器、配电柜、电缆、金具、绝缘子
③ 土建基础（串行）- 依赖① - 子项：基础开挖、基础浇筑、接地施工
④ 设备安装（串行）- 依赖②③ - 子项：变压器安装、配电柜安装、母线安装
⑤ 调试试验（串行）- 依赖④ - 子项：绝缘试验、耐压试验、保护调试
⑥ 竣工验收（串行）- 依赖⑤
⑦ 送电投运（串行）- 依赖⑥
模板2：架空线路工程
① 勘察设计（串行）- 无依赖
② 物资采购（并行）- 依赖① - 子项：电杆、导线、金具、绝缘子、避雷器
③ 基础施工（串行）- 依赖① - 子项：杆坑开挖、拉线坑开挖、基础浇筑
④ 杆塔组立（串行）- 依赖②③ - 子项：电杆组立、拉线安装
⑤ 架线施工（串行）- 依赖④ - 子项：放线、紧线、附件安装
⑥ 竣工验收（串行）- 依赖⑤
⑦ 送电投运（串行）- 依赖⑥
模板3：电缆敷设工程
...
模板4：变电站工程
...
模板5：小型工程
① 勘察设计（串行）
② 物资采购（并行）- 依赖①
③ 安装施工（串行）- 依赖②
④ 调试验收（串行）- 依赖③
⑤ 并网投运（串行）- 依赖④
十一、实施步骤
步骤1：创建缺失数据库表
-- 1. 物流单表（代码已引用，表未创建）
CREATE TABLE logistics_records (
id SERIAL PRIMARY KEY,
code VARCHAR(50) UNIQUE NOT NULL,
purchase_order_id INTEGER REFERENCES purchase_orders(id),
ship_from VARCHAR(100) DEFAULT 'China',
logistics_company_id INTEGER REFERENCES logistics_companies(id),
logistics_company VARCHAR(200),
tracking_number VARCHAR(100),
ship_date DATE,
ship_location VARCHAR(200),
estimated_arrival_date DATE,
customs_arrival_date DATE,
customs_clearance_date DATE,
use_hub BOOLEAN DEFAULT false,
hub_arrival_date DATE,
hub_receiver VARCHAR(100),
hub_verified_quantity BOOLEAN DEFAULT false,
second_ship_date DATE,
primary_freight NUMERIC(15,2) DEFAULT 0,
primary_freight_currency VARCHAR(10) DEFAULT 'CNY',
primary_freight_status VARCHAR(20) DEFAULT 'pending',
primary_freight_document TEXT,
secondary_freight NUMERIC(15,2) DEFAULT 0,
secondary_freight_currency VARCHAR(10) DEFAULT 'LAK',
secondary_freight_status VARCHAR(20) DEFAULT 'pending',
driver_phone VARCHAR(50),
cargo_weight NUMERIC(15,2),
transport_distance NUMERIC(15,2),
final_arrival_date DATE,
final_location VARCHAR(200),
status VARCHAR(20) DEFAULT 'pending',
remark TEXT,
created_by INTEGER REFERENCES users(id),
created_at TIMESTAMP DEFAULT NOW(),
updated_at TIMESTAMP DEFAULT NOW()
);
-- 2. 现场收货确认表
CREATE TABLE receiving_confirms (
id SERIAL PRIMARY KEY,
purchase_order_id INTEGER REFERENCES purchase_orders(id),
logistics_record_id INTEGER REFERENCES logistics_records(id),
confirm_date DATE DEFAULT CURRENT_DATE,
receiver_name VARCHAR(100),
receiver_phone VARCHAR(50),
received_location VARCHAR(200),
is_complete BOOLEAN DEFAULT true,
missing_items TEXT,
damage_items TEXT,
photo_urls TEXT[],
remark TEXT,
confirmed_by INTEGER REFERENCES users(id),
created_at TIMESTAMP DEFAULT NOW()
);
-- 3. 工程类型模板表
CREATE TABLE project_type_templates (
id SERIAL PRIMARY KEY,
name VARCHAR(100) NOT NULL,
description TEXT,
phases JSONB NOT NULL DEFAULT '[]',
is_system BOOLEAN DEFAULT false,
created_at TIMESTAMP DEFAULT NOW(),
updated_at TIMESTAMP DEFAULT NOW()
);
-- 4. 项目施工阶段表
CREATE TABLE project_phases (
id SERIAL PRIMARY KEY,
project_id INTEGER REFERENCES projects(id) ON DELETE CASCADE,
template_key VARCHAR(50),
phase_name VARCHAR(100) NOT NULL,
phase_order INTEGER NOT NULL,
phase_type VARCHAR(20) DEFAULT 'serial',
depends_on INTEGER[],
status VARCHAR(20) DEFAULT 'pending',
started_at TIMESTAMP,
completed_at TIMESTAMP,
completed_by INTEGER REFERENCES users(id),
remark TEXT,
photos TEXT[],
sub_items JSONB DEFAULT '[]',
created_at TIMESTAMP DEFAULT NOW()
);
-- 5. 分包商事件记录表
CREATE TABLE subcontractor_events (
id SERIAL PRIMARY KEY,
subcontractor_id INTEGER REFERENCES subcontractors(id),
project_id INTEGER REFERENCES projects(id),
event_type VARCHAR(10) NOT NULL,
score_change INTEGER NOT NULL,
event_date DATE NOT NULL,
title VARCHAR(200) NOT NULL,
description TEXT,
created_by INTEGER REFERENCES users(id),
created_at TIMESTAMP DEFAULT NOW()
);
步骤2：修改现有表
-- projects 增加字段
ALTER TABLE projects ADD COLUMN IF NOT EXISTS type_template_id INTEGER;
ALTER TABLE projects ADD COLUMN IF NOT EXISTS current_phase VARCHAR(50);
ALTER TABLE projects ADD COLUMN IF NOT EXISTS phase_progress NUMERIC(5,2) DEFAULT 0;
-- purchase_orders 增加字段
ALTER TABLE purchase_orders ADD COLUMN IF NOT EXISTS expected_delivery_date DATE;
ALTER TABLE purchase_orders ADD COLUMN IF NOT EXISTS receiving_status VARCHAR(20) DEFAULT 'pending';
-- subcontractors 增加字段
ALTER TABLE subcontractors ADD COLUMN IF NOT EXISTS score INTEGER DEFAULT 100;
ALTER TABLE subcontractors ADD COLUMN IF NOT EXISTS initial_score INTEGER DEFAULT 100;
步骤3：插入预设模板数据
INSERT INTO project_type_templates (name, description, phases, is_system) VALUES
('配电安装工程', '配电安装项目的标准阶段划分', '[
{"order":1,"name":"勘察设计","type":"serial","depends":[],"sub_items":["现场勘察","图纸设计","方案确认"]},
{"order":2,"name":"物资采购","type":"parallel","depends":[1],"sub_items":["电杆采购","变压器采购","配电柜采购","电缆采购","金具采购","绝缘子采购"]},
{"order":3,"name":"土建基础","type":"serial","depends":[1],"sub_items":["基础开挖","基础浇筑","接地施工"]},
{"order":4,"name":"设备安装","type":"serial","depends":[2,3],"sub_items":["变压器安装","配电柜安装","母线安装"]},
{"order":5,"name":"调试试验","type":"serial","depends":[4],"sub_items":["绝缘试验","耐压试验","保护调试"]},
{"order":6,"name":"竣工验收","type":"serial","depends":[5],"sub_items":[]},
{"order":7,"name":"送电投运","type":"serial","depends":[6],"sub_items":[]}
]', true),
('架空线路工程', '架空线路项目的标准阶段划分', '[
{"order":1,"name":"勘察设计","type":"serial","depends":[],"sub_items":["线路勘察","图纸设计"]},
{"order":2,"name":"物资采购","type":"parallel","depends":[1],"sub_items":["电杆采购","导线采购","金具采购","绝缘子采购","避雷器采购"]},
{"order":3,"name":"基础施工","type":"serial","depends":[1],"sub_items":["杆坑开挖","拉线坑开挖","基础浇筑"]},
{"order":4,"name":"杆塔组立","type":"serial","depends":[2,3],"sub_items":["电杆组立","拉线安装"]},
{"order":5,"name":"架线施工","type":"serial","depends":[4],"sub_items":["放线","紧线","附件安装"]},
{"order":6,"name":"竣工验收","type":"serial","depends":[5],"sub_items":[]},
{"order":7,"name":"送电投运","type":"serial","depends":[6],"sub_items":[]}
]', true),
('电缆敷设工程', '电缆敷设项目的标准阶段划分', '[
{"order":1,"name":"勘察设计","type":"serial","depends":[],"sub_items":["现场勘察","图纸设计"]},
{"order":2,"name":"物资采购","type":"parallel","depends":[1],"sub_items":["电缆采购","接头附件采购","管材采购"]},
{"order":3,"name":"电缆沟开挖","type":"serial","depends":[1],"sub_items":["沟道开挖","排管敷设"]},
{"order":4,"name":"电缆敷设","type":"serial","depends":[2,3],"sub_items":["电缆敷设","电缆固定"]},
{"order":5,"name":"接头制作","type":"serial","depends":[4],"sub_items":["中间接头","终端接头"]},
{"order":6,"name":"试验验收","type":"serial","depends":[5],"sub_items":["绝缘试验","耐压试验"]},
{"order":7,"name":"送电投运","type":"serial","depends":[6],"sub_items":[]}
]', true),
('变电站工程', '变电站项目的标准阶段划分', '[
{"order":1,"name":"勘察设计","type":"serial","depends":[],"sub_items":["现场勘察","初步设计","施工图设计"]},
{"order":2,"name":"物资采购","type":"parallel","depends":[1],"sub_items":["主变压器采购","开关柜采购","保护装置采购","电缆采购"]},
{"order":3,"name":"土建施工","type":"serial","depends":[1],"sub_items":["场地平整","基础施工","建筑物施工"]},
{"order":4,"name":"一次设备安装","type":"serial","depends":[2,3],"sub_items":["变压器安装","开关柜安装","母线安装"]},
{"order":5,"name":"二次设备安装","type":"serial","depends":[4],"sub_items":["保护屏安装","控制电缆敷设","直流系统安装"]},
{"order":6,"name":"调试试验","type":"serial","depends":[5],"sub_items":["单体调试","系统联调","保护试验"]},
{"order":7,"name":"竣工验收","type":"serial","depends":[6],"sub_items":[]},
{"order":8,"name":"送电投运","type":"serial","depends":[7],"sub_items":[]}
]', true),
('小型工程（光伏/充电桩/户表等）', '小型项目的标准阶段划分', '[
{"order":1,"name":"勘察设计","type":"serial","depends":[],"sub_items":["现场勘察","方案设计"]},
{"order":2,"name":"物资采购","type":"parallel","depends":[1],"sub_items":["设备采购","材料采购"]},
{"order":3,"name":"安装施工","type":"serial","depends":[2],"sub_items":["设备安装","线路连接"]},
{"order":4,"name":"调试验收","type":"serial","depends":[3],"sub_items":["系统调试","验收检查"]},
{"order":5,"name":"并网投运","type":"serial","depends":[4],"sub_items":[]}
]', true);
步骤4：后端 —— 工程模板管理接口
创建 /backend/routes/process-templates.js：
GET /api/process-templates- 获取所有模板列表GET /api/process-templates/:id- 获取模板详情POST /api/process-templates- 创建自定义模板PUT /api/process-templates/:id- 更新自定义模板DELETE /api/process-templates/:id- 删除自定义模板（系统模板不可删）POST /api/process-templates/:id/copy- 复制模板（包括系统模板）
在 app.js 注册路由：
app.use('/api/process-templates', require('./routes/process-templates'));
步骤5：后端 —— 项目阶段管理接口
修改 /backend/routes/projects.js，新增阶段相关接口：
GET /api/projects/:id/phases- 获取项目的所有阶段PUT /api/projects/:id/phases/:phaseId/complete- 完成某个阶段PUT /api/projects/:id/phases/:phaseId/reopen- 重新打开某个阶段PUT /api/projects/:id/phases/:phaseId/sub-item- 更新子项状态
阶段完成时自动：
- 更新
project_phases.status = 'completed' - 更新
projects.current_phase为下一阶段 - 重新计算
projects.phase_progress
步骤6：后端 —— 物流管理接口
已存在 /backend/routes/logistics.js，但表 logistics_records 未创建。
- ✅ 步骤1中已创建表 → 直接可用
步骤7：后端 —— 收货确认接口
创建 /backend/routes/receiving.js：
POST /api/receiving- 创建收货确认GET /api/receiving/:purchase_order_id- 获取订单的收货记录PUT /api/receiving/:id- 更新收货信息
收货确认时自动：
- 更新
purchase_orders.receiving_status - 更新
inventory_records（库存入库）
步骤8：后端 —— 分包商事件接口
修改 /backend/routes/subcontractors.js，新增：
GET /api/subcontractors/:id/events- 获取分包商事件列表POST /api/subcontractors/:id/events- 添加事件DELETE /api/subcontractors/:id/events/:eventId- 删除事件
添加/删除事件时自动更新 subcontractors.score。
步骤9：后端 —— 修改预算签约接口
修改 /backend/routes/budget.js 的 PUT /:id/sign：
- 接收
type_template_id参数 - 创建 projects 后，自动从模板复制阶段到 project_phases
步骤10：后端 —— 修改项目创建接口
修改 /backend/routes/projects.js 的 POST /：
- 接收
type_template_id参数 - 创建项目后，自动从模板复制阶段到 project_phases
步骤11：前端 —— 后台管理 → 工程模板设计器
新建文件：
/frontend/src/pages/admin/ProcessTemplates.tsx- 模板列表页/frontend/src/pages/admin/ProcessTemplateForm.tsx- 模板新建/编辑页（三步向导）
在 AdminLayout 增加菜单项和路由。
步骤12：前端 —— 项目详情页重构
修改 ProjectDetail.tsx：
- 重新组织为7个Tab（基本信息、合同与收款、分包管理、材料管理、财务收支、质保金、施工日志）
- Tab2 合同与收款：独立管理收款节点，与施工进度解耦
- Tab3 分包管理：增加事件记录和评分显示
- Tab4 材料管理：改为只读汇总，数据来自采购系统
- 顶部增加施工进度预览条 + "进入施工管理"按钮
步骤13：前端 —— 施工总览页（新建）
新建文件：
/frontend/src/pages/construction/ConstructionOverview.tsx
功能：
- 显示所有"进行中"项目的施工进度条
- 当前阶段、收款比例
- 延期预警
- 点击进入施工进度页
步骤14：前端 —— 施工进度页（新建）
新建文件：
/frontend/src/pages/construction/ConstructionProgress.tsx
功能：
- 手机友好的轻量确认台
- 阶段进度条（顶部）
- 当前阶段操作区（子项勾选、拍照、完成确认）
- 阶段历史折叠
步骤15：前端 —— 采购订单物流详情
修改 PurchaseOrdersPage.tsx：
- 增加物流信息Tab（预计送达、物流公司、运输状态）
- 增加收货确认Tab（拍照、完整性检查）
步骤16：前端 —— 分包商管理增强
修改 SubcontractorsPage.tsx 和 SubcontractorDetail.tsx：
- 分包商列表增加分数列
- 详情增加事件记录Tab
- 事件添加弹出表单（事件类型、分数变化、标题、描述）
步骤17：前端 —— 创建项目增加选模板步骤
修改 ProjectsPage.tsx 新建项目流程：
- 步骤1：选择工程类型模板
- 步骤2：填写基本信息
修改 BudgetProjectDetail.tsx 签约流程：
- 签约弹窗中增加模板选择
步骤18：前端 —— 施工日志调整
ConstructionLog.tsx → 从项目详情Tab中独立出来，也可以从施工总览页进入。
步骤19：前端 —— 菜单和路由更新
修改 MainLayout.tsx：
- 施工管理菜单增加"施工总览"子项
- 调整菜单结构一致
修改 App.tsx：
- 增加施工总览、施工进度、模板管理路由
步骤20：清理和验证
- 删除旧的
construction/ConstructionList.tsx（已被施工总览替代） - 删除旧的
construction/ConstructionMilestones.tsx（已被施工进度替代） - 全套测试：创建模板 → 创建项目 → 推进阶段 → 采购订单 → 物流 → 收货 → 分包评分
十二、预制数据
物流记录状态枚举
pending 待发货
in_transit 运输中
at_customs 海关清关中
at_hub 中转仓
secondary 二次运输中
arrived 已到达现场
项目状态枚举
planning 已立项
active 施工中
suspended 暂停
completed 已完工
阶段状态枚举
pending 待开始
in_progress 进行中
completed 已完成
skipped 已跳过