999 lines
44 KiB
Markdown
999 lines
44 KiB
Markdown
# 公司财务ERP系统 - 项目管理大改造设计方案
|
||
|
||
> 创建日期：2026-05-14
|
||
> 状态：设计方案已完成，待实施
|
||
|
||
---
|
||
|
||
## 一、改造目标
|
||
|
||
1. **施工进度与收款彻底分离** —— 两条独立轨道运行
|
||
2. **工程类型模板系统** —— 不同类型工程有不同施工阶段，支持串/并联
|
||
3. **施工进度推进简单化** —— 阶段确认 → 勾选完成，不绑定业务数据
|
||
4. **物资采购全流程** —— 采购申请→审批→订单→物流→现场收货，一条龙
|
||
5. **分包商事件评分** —— 事件记录加减分，初始100分
|
||
6. **历史数据批量补录** —— Excel导入 + source字段（统一收支表之后做）
|
||
|
||
---
|
||
|
||
## 二、导航结构（改造后）
|
||
|
||
```
|
||
🏠 工作台
|
||
|
||
📋 项目管理
|
||
├── 项目列表
|
||
└── 项目详情（7个Tab）
|
||
├── 基本信息
|
||
├── 合同与收款
|
||
├── 分包管理
|
||
├── 材料管理（只读汇总）
|
||
├── 财务收支
|
||
├── 质保金
|
||
└── 施工日志
|
||
[进入施工管理 →]
|
||
|
||
💰 商谈报价
|
||
├── 商谈列表
|
||
├── 新建商谈
|
||
└── 商谈详情
|
||
|
||
🔨 施工管理（独立模块）
|
||
├── 施工总览
|
||
├── 施工进度（轻量确认台）
|
||
└── 施工日志
|
||
|
||
📝 财务申请
|
||
├── 预支申请
|
||
├── 付款申请
|
||
├── 报销申请
|
||
└── 核销申请
|
||
|
||
✅ 审批管理
|
||
├── 待审批
|
||
└── 待执行
|
||
|
||
📊 财务管理
|
||
├── 财务概览
|
||
├── 项目收支
|
||
├── 汇率管理
|
||
└── 预支核销状态
|
||
|
||
🛒 采购管理
|
||
├── 商品管理
|
||
├── 采购申请
|
||
├── 采购订单
|
||
├── 付款计划
|
||
└── 库存管理
|
||
|
||
🤝 合作伙伴
|
||
├── 供应商管理
|
||
├── 分包商管理
|
||
├── 客户管理
|
||
└── 物流管理
|
||
|
||
📈 报表分析
|
||
|
||
⚙️ 后台管理 /admin
|
||
├── 用户管理
|
||
├── 角色权限
|
||
├── 流程管理
|
||
├── 工程模板管理 ← 新增
|
||
├── 系统日志
|
||
├── 数据备份
|
||
└── 关于系统
|
||
```
|
||
|
||
---
|
||
|
||
## 三、数据库改造
|
||
|
||
### 3.1 新增表
|
||
|
||
#### 工程类型模板表
|
||
```sql
|
||
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()
|
||
);
|
||
```
|
||
|
||
#### 项目施工阶段表
|
||
```sql
|
||
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()
|
||
);
|
||
```
|
||
|
||
#### 物流单表（代码已引用但表不存在！）
|
||
```sql
|
||
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()
|
||
);
|
||
```
|
||
|
||
#### 现场收货确认表
|
||
```sql
|
||
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()
|
||
);
|
||
```
|
||
|
||
#### 分包商事件记录表
|
||
```sql
|
||
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 表增加字段
|
||
```sql
|
||
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 表增加字段
|
||
```sql
|
||
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 表增加字段
|
||
```sql
|
||
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 接口中：
|
||
1. 签约时要求传入 `type_template_id` 参数
|
||
2. 签约成功创建 projects 后，自动从模板复制阶段到 project_phases
|
||
|
||
---
|
||
|
||
## 九、数据补录方案（后续实施）
|
||
|
||
1. 先完成系统改造，统一收支表结构
|
||
2. 增加 `source` 字段标记数据来源（normal/import/summary）
|
||
3. 设计 Excel 模板批量导入
|
||
4. 报表按分类汇总，不论来源
|
||
|
||
---
|
||
|
||
## 十、预设模板数据
|
||
|
||
### 模板1：配电安装工程
|
||
```
|
||
① 勘察设计（串行）- 无依赖
|
||
② 物资采购（并行）- 依赖① - 子项：电杆、变压器、配电柜、电缆、金具、绝缘子
|
||
③ 土建基础（串行）- 依赖① - 子项：基础开挖、基础浇筑、接地施工
|
||
④ 设备安装（串行）- 依赖②③ - 子项：变压器安装、配电柜安装、母线安装
|
||
⑤ 调试试验（串行）- 依赖④ - 子项：绝缘试验、耐压试验、保护调试
|
||
⑥ 竣工验收（串行）- 依赖⑤
|
||
⑦ 送电投运（串行）- 依赖⑥
|
||
```
|
||
|
||
### 模板2：架空线路工程
|
||
```
|
||
① 勘察设计（串行）- 无依赖
|
||
② 物资采购（并行）- 依赖① - 子项：电杆、导线、金具、绝缘子、避雷器
|
||
③ 基础施工（串行）- 依赖① - 子项：杆坑开挖、拉线坑开挖、基础浇筑
|
||
④ 杆塔组立（串行）- 依赖②③ - 子项：电杆组立、拉线安装
|
||
⑤ 架线施工（串行）- 依赖④ - 子项：放线、紧线、附件安装
|
||
⑥ 竣工验收（串行）- 依赖⑤
|
||
⑦ 送电投运（串行）- 依赖⑥
|
||
```
|
||
|
||
### 模板3：电缆敷设工程
|
||
```
|
||
...
|
||
```
|
||
|
||
### 模板4：变电站工程
|
||
```
|
||
...
|
||
```
|
||
|
||
### 模板5：小型工程
|
||
```
|
||
① 勘察设计（串行）
|
||
② 物资采购（并行）- 依赖①
|
||
③ 安装施工（串行）- 依赖②
|
||
④ 调试验收（串行）- 依赖③
|
||
⑤ 并网投运（串行）- 依赖④
|
||
```
|
||
---
|
||
|
||
## 十一、实施步骤
|
||
|
||
### 步骤1：创建缺失数据库表
|
||
|
||
```sql
|
||
-- 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：修改现有表
|
||
|
||
```sql
|
||
-- 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：插入预设模板数据
|
||
|
||
```sql
|
||
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` 注册路由：
|
||
```javascript
|
||
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 已跳过
|
||
```
|