Files
yunhaifinance/.trae/specs/erp-system/项目管理框架设计方案.md

69 KiB
Raw Permalink Blame History

项目管理完整方案 V5

更新时间: 2026-03-18 版本: V5


一、系统模块总览

┌─────────────────────────────────────────────────────────────────┐
│                         ERP系统                                  │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌──────────────────────┐                    ┌────────────────┐ │
│  │                      │    签约成功        │                │ │
│  │    预算报价管理       │ ────────────────> │   项目管理     │ │
│  │    (签约前)          │                    │   (签约后)     │ │
│  │                      │ <────────────────  │                │ │
│  └──────────────────────┘    数据关联(隐藏)   └────────────────┘ │
│                                                                 │
│  菜单入口:                                                      │
│  ├─ 预算报价管理                                               │
│  │   └─ 项目商谈、报价、签约                                   │
│  │                                                              │
│  ├─ 项目管理                                                   │
│  │   └─ 合同执行、施工、结算                                    │
│  │                                                              │
│  └─ 施工管理(员工入口)                                       │
│      └─ 施工日志、照片上传                                      │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

二、预算报价管理(签约前)

2.1 列表页设计

┌─────────────────────────────────────────────────────────────────┐
│  预算报价管理                              [新建商谈项目]        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  状态筛选: [全部] [商谈中] [已签约] [未签约]                    │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ ▼ 博纳斯一车间到三车间22kV线路项目       商谈中  5天     │   │
│  │   客户: 博纳斯稀土开采独资有限公司                        │   │
│  │   业务经理: 罗仕林                                        │   │
│  │   ├─ 报价V1  2026-03-10  ¥115,500  草稿   [编辑][删除]   │   │
│  │   ├─ 报价V2  2026-03-12  ¥120,000  已发送 [查看][删除]   │   │
│  │   └─ 报价V3  2026-03-15  ¥118,000  已发送 [查看][删除]   │   │
│  │   [新增报价版本]  [标记签约] [标记未签约]                 │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ ▶ 万象市中心配电房改造项目               已签约  15天    │   │
│  │   客户: 老挝国家电力公司                                  │   │
│  │   业务经理: 罗仕林                                        │   │
│  │   └─ 报价V1  2026-03-01  ¥85,000  已签约                 │   │
│  │                               [查看] [进入项目管理]       │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ ▼ 南塔省输电线路项目                     未签约  32天    │   │
│  │   客户: 南塔电力公司                                      │   │
│  │   业务经理: 李四                                          │   │
│  │   └─ 报价V1  2026-02-15  ¥200,000  未签约                │   │
│  │   未签约原因: 价格过高                                    │   │
│  │   [编辑] [恢复商谈] [新增报价]                            │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  共 15 条记录                                                  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

2.2 新建商谈项目(勘察录入)

┌─────────────────────────────────────────────────────────────────┐
│  新建商谈项目(勘察录入)                                       │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│  基本信息                                                       │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  项目名称 *:     [                              ]               │
│                                                                 │
│  客户 *:         [ 选择客户 ▼ ]               [新建客户]        │
│                                                                 │
│  业务经理 *:     [ 选择人员 ▼ ]                               │
│                                                                 │
│  项目地点:       [                              ]               │
│                                                                 │
│  勘察日期:       [ 2026-03-18 ]                               │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│  居间人信息                                                     │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  居间人:         [                              ]               │
│                                                                 │
│  居间费类型:     ○ 固定金额    ○ 百分比                       │
│                                                                 │
│  居间费:         [          ] 元  或  [    ] %                 │
│                  (按合同金额×比例自动计算)                     │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│  工程基本情况                                                   │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  客户要求:       [                              ]               │
│                  [                              ]               │
│                  [                              ]               │
│                                                                 │
│  工程概况:       [                              ]               │
│                  [                              ]               │
│                  [                              ]               │
│                                                                 │
│  附件上传:                                                     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 📄 地形图.pdf    📄 电路图.dwg    📄 勘察报告.docx   │   │
│  │ [+ 上传文件]                                         │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  勘察照片:                                                     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ [图片1] [图片2] [图片3] [图片4] [+ 上传图片]          │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│               [ 取消 ]              [ 保存 ]                   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

2.3 新增报价版本

┌─────────────────────────────────────────────────────────────────┐
│  新增报价版本                                                   │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  项目名称: 博纳斯一车间到三车间22kV线路项目                     │
│  当前版本: V3                                                   │
│                                                                 │
│  报价日期 *:     [ 2026-03-18 ]                               │
│                                                                 │
│  报价金额 *:     [          ] 元                              │
│                                                                 │
│  币种:           [ CNY ▼ ]                                    │
│                                                                 │
│  报价文件:       [ 上传文件 ]                                 │
│                                                                 │
│  备注:           [                              ]               │
│                                                                 │
│               [ 取消 ]              [ 保存 ]                   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

2.4 状态流转

┌─────────────────────────────────────────────────────────────────┐
│                        状态流转图                                │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│                    ┌──────────────┐                             │
│                    │   新建项目   │                             │
│                    └──────┬───────┘                             │
│                           │                                     │
│                           ▼                                     │
│                    ┌──────────────┐                             │
│          ┌────────│   商谈中     │────────┐                    │
│          │        └──────────────┘        │                    │
│          │              │                  │                    │
│          │              │ 30天未操作       │ 手动点击           │
│          │              ▼                  ▼                    │
│          │        ┌──────────────┐  ┌──────────────┐            │
│          │        │ 自动归档     │  │   未签约     │            │
│          │        │ (未签约)     │  │              │            │
│          │        └──────────────┘  └──────┬───────┘            │
│          │                                   │                    │
│          │                                   │ 恢复商谈           │
│          │                                   ▼                    │
│          │                            ┌──────────────┐          │
│          │                            │   商谈中     │          │
│          │                            └──────────────┘          │
│          │                                                       │
│          │ 手动点击签约                                           │
│          ▼                                                       │
│   ┌──────────────┐                                              │
│   │   已签约     │ ──────────────────> 进入项目管理             │
│   └──────────────┘                                              │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

2.5 提醒机制

提醒规则:
┌─────────────────────────────────────────────────────────────────┐
│  触发条件: 状态为"商谈中" 且 距最后一次报价超过7天              │
│                                                                 │
│  提醒频率: 每7天提醒一次                                        │
│                                                                 │
│  提醒对象:                                                      │
│  ├─ 所有管理员                                                  │
│  └─ 关联的业务经理                                              │
│                                                                 │
│  提醒内容:                                                      │
│  ├─ 项目名称                                                    │
│  ├─ 客户名称                                                    │
│  ├─ 最后报价日期                                                │
│  ├─ 距今天数                                                    │
│  └─ 操作链接                                                    │
│                                                                 │
│  30天自动归档:                                                  │
│  ├─ 第25天: 提醒"即将自动归档"                                  │
│  └─ 第30天: 自动标记为"未签约"                                  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

三、项目管理(签约后)

3.1 项目列表

┌─────────────────────────────────────────────────────────────────┐
│  项目管理                                  [状态筛选] [搜索]    │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  状态筛选: [全部] [进行中] [已完工] [已完成] [已暂停]           │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 项目名称            │ 客户     │ 金额    │ 状态   │ 操作│   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ 博纳斯22kV线路项目  │ 博纳斯   │ ¥115,500│ 施工中 │ [进入]│   │
│  │ 万象配电房改造      │ 老挝电力 │ ¥85,000 │ 已完工 │ [进入]│   │
│  │ 南塔输电线路        │ 南塔电力 │ ¥200,000│ 已完成 │ [进入]│   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

3.2 项目详情页Tab设计

┌─────────────────────────────────────────────────────────────────┐
│  项目名称: 博纳斯一车间到三车间22kV线路项目                     │
│  状态: 施工中    │    进度: 60%    │    质保金: ¥5,775         │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  [基本信息] [合同详情] [分包管理] [材料管理] [施工节点] [施工日志] [财务信息] [质保金] │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

3.3 基本信息 Tab

┌─────────────────────────────────────────────────────────────────┐
│  [基本信息] [合同详情] [分包管理] [材料管理] [施工节点] [施工日志] [财务信息] [质保金] │
│   ════════                                                      │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  项目编号: PRJ260317001                                         │
│  项目名称: 博纳斯一车间到三车间22kV线路项目                     │
│  客户:     博纳斯稀土开采独资有限公司                           │
│  项目经理: 罗仕林                                               │
│  项目地点: 老挝万象省博纳斯矿区                                 │
│  项目状态: 施工中                                               │
│                                                                 │
│  工程概况:                                                      │
│  从一车间到三车间新建7公里22kV高压输电线路,                    │
│  安装1250kVA变压器1台,包含基础施工、设备安装、调试等。         │
│                                                                 │
│  客户要求:                                                      │
│  需在雨季前完工,确保供电稳定性                                 │
│                                                                 │
│  勘察照片: [图片1] [图片2] [图片3]                              │
│                                                                 │
│  附件文件: [地形图.pdf] [电路图.dwg] [勘察报告.docx]            │
│                                                                 │
│  创建时间: 2026-03-18                                           │
│  更新时间: 2026-03-20                                           │
│                                                                 │
│                                              [编辑基本信息]     │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

3.4 合同详情 Tab

┌─────────────────────────────────────────────────────────────────┐
│  [基本信息] [合同详情] [分包管理] [材料管理] [施工节点] [施工日志] [财务信息] [质保金] │
│            ════════                                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  合同信息                                                       │
│  ─────────────────────────────────────────────────────────────  │
│  合同编号: HT-2026-001                                          │
│  合同金额: ¥115,500                                             │
│  币种:     CNY                                                  │
│  结算方式: 单价结算                                             │
│  合同工期: 100 天                                               │
│  开工日期: 2026-03-20                                           │
│  完工日期: 2026-06-28 (预计)                                    │
│                                                                 │
│  单价明细                                                       │
│  ─────────────────────────────────────────────────────────────  │
│  项目内容              │ 单价    │ 暂定工程量 │ 暂定总价       │
│  ─────────────────────────────────────────────────────────────  │
│  22kV线路安装          │ ¥15,000/km │ 7 km    │ ¥105,000      │
│  变压器安装            │ ¥10,500/台 │ 1 台    │ ¥10,500       │
│  ─────────────────────────────────────────────────────────────  │
│  合计                  │          │          │ ¥115,500       │
│                                                                 │
│  付款节点                                                       │
│  ─────────────────────────────────────────────────────────────  │
│  节点名称     │ 比例  │ 金额     │ 状态   │ 预计日期          │
│  ─────────────────────────────────────────────────────────────  │
│  预付款       │ 30%   │ ¥34,650  │ 已付款 │ 2026-03-20        │
│  进度款       │ 40%   │ ¥46,200  │ 待付款 │ 2026-05-15        │
│  完工款       │ 25%   │ ¥28,875  │ 待付款 │ 2026-06-28        │
│  质保金       │ 5%    │ ¥5,775   │ 待释放 │ 2027-06-28        │
│  ─────────────────────────────────────────────────────────────  │
│  合计         │ 100%  │ ¥115,500 │        │                   │
│                                                                 │
│  质保金设置                                                     │
│  ─────────────────────────────────────────────────────────────  │
│  是否有质保金: 是                                               │
│  质保金比例:   5%                                               │
│  质保金金额:   ¥5,775                                           │
│  质保期限:     12 个月                                          │
│  到期日期:     2027-06-28                                       │
│                                                                 │
│  合同文件: [合同扫描件.pdf]                                     │
│                                                                 │
│                                              [编辑合同详情]     │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

3.5 分包管理 Tab

┌─────────────────────────────────────────────────────────────────┐
│  [基本信息] [合同详情] [分包管理] [材料管理] [施工节点] [施工日志] [财务信息] [质保金] │
│                     ═══════════                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  分包合同列表                                    [新增分包]     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 分包商       │ 合同金额   │ 已付款   │ 状态   │ 操作    │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ 老挝电力工程 │ ¥50,000    │ ¥30,000  │ 进行中 │ [详情]  │   │
│  │ 万象建材公司 │ ¥15,000    │ ¥15,000  │ 已完成 │ [详情]  │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  分包合计: ¥65,000    已付款: ¥45,000                         │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

3.6 材料管理 Tab

┌─────────────────────────────────────────────────────────────────┐
│  [基本信息] [合同详情] [分包管理] [材料管理] [施工节点] [施工日志] [财务信息] [质保金] │
│                          ═══════════                            │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  项目材料汇总                                                   │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 商品名称       │单位│ 预算量 │ 采购量 │使用量│ 均价  │ 总价  │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ 22kV高压电缆   │ 米 │ 7000   │ 7200   │ 6500 │ ¥85  │¥612,000│   │
│  │ 变压器1250kVA  │ 台 │ 1      │ 1      │ 1    │¥80,000│¥80,000│   │
│  │ 电缆终端头     │ 套 │ 6      │ 6      │ 4    │¥1,200 │ ¥7,200│   │
│  │ 接地线         │ 米 │ 500    │ 500    │ 400  │ ¥25  │¥12,500│   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  说明:                                                         │
│  - 预算量: 合同预算工程量                                      │
│  - 采购量: 该项目实际采购数量                                  │
│  - 使用量: 施工现场已使用数量                                  │
│  - 均价: 多次采购的平均单价                                    │
│  - 总价 = 采购量 × 均价                                        │
│                                                                 │
│  材料采购明细: [查看采购批次]                                  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

3.7 施工节点 Tab

┌─────────────────────────────────────────────────────────────────┐
│  [基本信息] [合同详情] [分包管理] [材料管理] [施工节点] [施工日志] [财务信息] [质保金] │
│                                   ═══════════                  │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  合同付款节点                                                   │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 节点名称 │ 比例 │ 金额    │ 完成进度 │ 状态   │ 操作   │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ 预付款    │ 30%  │ ¥34,650 │ 100%     │ 已完成 │ [查看] │   │
│  │          │      │         │ 📎凭证1  │        │        │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ 进度款    │ 40%  │ ¥46,200 │ 60%      │ 进行中 │ [上传] │   │
│  │          │      │         │ 📎凭证2  │        │        │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ 完工款    │ 25%  │ ¥28,875 │ 0%       │ 待开始 │        │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ 质保金    │ 5%   │ ¥5,775  │ 0%       │ 待释放 │        │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  重要节点完成情况                                              │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ ✓ 设备到场  2026-04-10  [查看凭证]                    │   │
│  │ ✓ 基础完工 2026-04-15  [查看凭证]                    │   │
│  │ ○ 竣工验收  -           [上传凭证]                    │   │
│  │ ○ 并网通电  -           [上传凭证]                    │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

3.8 施工日志 Tab

┌─────────────────────────────────────────────────────────────────┐
│  [基本信息] [合同详情] [分包管理] [材料管理] [施工节点] [施工日志] [财务信息] [质保金] │
│                                             ═══════════          │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  施工日志列表                                    [+ 新增日志]     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 📅 2026-04-15  天气: 晴                              │   │
│  │ 记录人: 张三                                            │   │
│  │ 今日工作: 完成1号变压器基础浇筑                         │   │
│  │ 照片: [图1] [图2] [图3]                               │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ 📅 2026-04-14  天气: 雨                              │   │
│  │ 记录人: 李四                                            │   │
│  │ 今日工作: 铺设电缆沟渠50米                              │   │
│  │ 照片: [图1] [图2]                                     │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

3.9 财务信息 Tab

┌─────────────────────────────────────────────────────────────────┐
│  [基本信息] [合同详情] [分包管理] [材料管理] [施工节点] [施工日志] [财务信息] [质保金] │
│                                      ═════════                  │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ╔═══════════════════════════════════════════════════════════╗ │
│  ║                    合同与结算对比                          ║ │
│  ╠═══════════════════════════════════════════════════════════╣ │
│  ║                                                           ║ │
│  ║  结算方式: 单价结算                                       ║ │
│  ║                                                           ║ │
│  ║  ┌─────────────────────────────────────────────────────┐ ║ │
│  ║  │ 项目内容      │ 单价      │ 暂定量 │ 实际量 │ 差异  │ ║ │
│  ║  ├─────────────────────────────────────────────────────┤ ║ │
│  ║  │ 22kV线路安装  │ ¥15,000/km│ 7 km  │ 7.5 km │ +0.5km│ ║ │
│  ║  │ 变压器安装    │ ¥10,500/台│ 1 台  │ 1 台   │ 0     │ ║ │
│  ║  ├─────────────────────────────────────────────────────┤ ║ │
│  ║  │ 暂定总价      │           │       │ ¥115,500│      │ ║ │
│  ║  │ 实际总价      │           │       │ ¥123,000│ +7.5%│ ║ │
│  ║  │ 结算差异      │           │       │ +¥7,500 │      │ ║ │
│  ║  └─────────────────────────────────────────────────────┘ ║ │
│  ║                                                           ║ │
│  ╚═══════════════════════════════════════════════════════════╝ │
│                                                                 │
│  ╔═══════════════════════════════════════════════════════════╗ │
│  ║                    收款情况                                ║ │
│  ╠═══════════════════════════════════════════════════════════╣ │
│  ║                                                           ║ │
│  ║  合同暂定金额: ¥115,500                                   ║ │
│  ║  实际结算金额: ¥123,000  (+7.5%)                         ║ │
│  ║  ───────────────────────────────────────────────────────  ║ │
│  ║  已收款:       ¥92,250   (75%)                            ║ │
│  ║  待收款:       ¥25,125   (20.4%)                          ║ │
│  ║  质保金:       ¥6,150    (5%)  待释放                     ║ │
│  ║  ───────────────────────────────────────────────────────  ║ │
│  ║  合计:         ¥123,000  (100%)                           ║ │
│  ║                                                           ║ │
│  ╚═══════════════════════════════════════════════════════════╝ │
│                                                                 │
│  ╔═══════════════════════════════════════════════════════════╗ │
│  ║                    支出情况                                ║ │
│  ╠═══════════════════════════════════════════════════════════╣ │
│  ║                                                           ║ │
│  ║  预支总额:     ¥20,000    [查看明细]                      ║ │
│  ║  报销总额:     ¥15,000    [查看明细]                      ║ │
│  ║  分包付款:     ¥35,000    [查看明细]                      ║ │
│  ║  ───────────────────────────────────────────────────────  ║ │
│  ║  支出合计:     ¥70,000                                    ║ │
│  ║                                                           ║ │
│  ╚═══════════════════════════════════════════════════════════╝ │
│                                                                 │
│  ╔═══════════════════════════════════════════════════════════╗ │
│  ║                    利润概况                                ║ │
│  ╠═══════════════════════════════════════════════════════════╣ │
│  ║                                                           ║ │
│  ║  实际结算金额: ¥123,000                                   ║ │
│  ║  支出合计:     ¥70,000                                    ║ │
│  ║  ───────────────────────────────────────────────────────  ║ │
│  ║  毛利润:       ¥53,000    (43.1%)                         ║ │
│  ║                                                           ║ │
│  ╚═══════════════════════════════════════════════════════════╝ │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

3.10 质保金 Tab

┌─────────────────────────────────────────────────────────────────┐
│  [基本信息] [合同详情] [分包管理] [材料管理] [施工节点] [施工日志] [财务信息] [质保金] │
│                                                        ════════│
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  质保金信息                                                     │
│  ─────────────────────────────────────────────────────────────  │
│  质保金金额:   ¥5,775                                           │
│  质保比例:     5%                                               │
│  质保期限:     12 个月                                          │
│  起算日期:     2026-06-28 (完工日期)                            │
│  到期日期:     2027-06-28                                       │
│  剩余天数:     365 天                                           │
│  状态:         待释放                                           │
│                                                                 │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  质保金状态: [待释放]                                           │
│                                                                 │
│  操作:                                                          │
│  [标记已释放]  [延期]  [备注]                                   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

四、施工管理独立入口(员工快速访问)

4.1 用户权限设计

┌─────────────────────────────────────────────────────────────────┐
│                      用户角色与权限                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  管理员:   可访问所有功能                                       │
│                                                                 │
│  项目经理: 可访问所负责项目的 所有Tab                           │
│                                                                 │
│  施工人员: 专属"施工管理"入口                                   │
│            - 查看所负责项目列表                                  │
│            - 录入施工日志                                       │
│            - 上传施工照片                                        │
│            - 查看施工节点完成情况                                │
│            - ❌ 无财务信息                                       │
│            - ❌ 无质保金                                        │
│                                                                 │
│  预算人员: 预算报价管理 + 项目管理(只读)                       │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

4.2 施工管理入口

┌─────────────────────────────────────────────────────────────────┐
│  施工管理                                                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  我的施工项目                                                    │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 🎯 博纳斯22kV线路项目                    施工中          │   │
│  │    客户: 博纳斯稀土                                         │   │
│  │    进度: 60%                                              │   │
│  │    ───────────────────────────────────────               │   │
│  │    [📝 施工日志] [📷 上传照片] [📋 节点进度]             │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ 🎯 万象配电房改造                          完工          │   │
│  │    客户: 老挝国家电力                                       │   │
│  │    进度: 100%                                             │   │
│  │    ───────────────────────────────────────               │   │
│  │    [📝 施工日志] [📷 上传照片] [📋 节点进度]             │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

4.3 移动端施工日志录入

┌─────────────────────────┐
│  🏠 施工管理            │
├─────────────────────────┤
│                         │
│  [我的项目]             │
│  ┌───────────────────┐ │
│  │ 🎯 博纳斯22kV    │ │
│  │    进度: 60%    │ │
│  └───────────────────┘ │
│                         │
│  ─────────────────────│
│                         │
│  📝 写施工日志         │
│  ┌───────────────────┐ │
│  │ 日期: 2026-04-15 │ │
│  │ 天气: ☀️ 晴      │ │
│  │                   │ │
│  │ 今天做了什么?    │ │
│  │ [              ] │ │
│  │                   │ │
│  │ 明天计划做什么?  │ │
│  │ [              ] │ │
│  │                   │ │
│  │ 📷 上传照片      │ │
│  │ [+]              │ │
│  │                   │ │
│  │   [ 提 交 ]      │ │
│  └───────────────────┘ │
│                         │
└─────────────────────────┘

五、质保金管理窗口(全局)

┌─────────────────────────────────────────────────────────────────┐
│  质保金管理                                          [×]        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  筛选: [全部] [即将到期] [已到期] [已释放]                      │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 项目名称          │ 金额    │ 到期日期   │ 剩余天数 │ 状态│   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ ⚠️ 万象配电房改造 │ ¥4,250 │ 2026-04-15 │ 15天    │即将到期│   │
│  │ 博纳斯22kV线路    │ ¥5,775 │ 2027-06-28 │ 365天   │待释放 │   │
│  │ 南塔输电线路      │ ¥10,000│ 2026-03-01 │ 已到期  │已到期 │   │
│  │ 琅勃拉邦商场      │ ¥3,500 │ 2026-01-15 │ 已释放  │已释放 │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  即将到期提醒(30天内):                                        │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ ⚠️ 万象配电房改造 质保金 ¥4,250 将于 15天后到期          │   │
│  │    [标记已释放]  [延期]  [查看项目]                       │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

六、数据库设计

-- ============================================
-- 预算报价管理(签约前)
-- ============================================

-- 预算报价项目表
CREATE TABLE budget_projects (
  id SERIAL PRIMARY KEY,
  budget_code VARCHAR(50) UNIQUE,          -- 预算编号
  name VARCHAR(255) NOT NULL,              -- 项目名称
  customer_id INTEGER REFERENCES customers(id),
  location VARCHAR(255),                   -- 项目地点
  survey_date DATE,                        -- 勘察日期
  survey_notes TEXT,                       -- 工程概况
  customer_requirements TEXT,              -- 客户要求
  
  -- 居间人信息(勘察时录入)
  intermediary_name VARCHAR(100),          -- 居间人
  intermediary_fee_type VARCHAR(10),       -- 'fixed' 或 'percent'
  intermediary_fee DECIMAL(15,2),          -- 居间费金额或比例
  
  -- 业务信息
  business_manager_id INTEGER REFERENCES users(id),  -- 业务经理
  
  -- 状态
  status VARCHAR(20) DEFAULT 'negotiating', -- negotiating/signed/unsigned
  last_quotation_at TIMESTAMP,             -- 最后报价时间
  unsigned_reason VARCHAR(255),            -- 未签约原因
  
  -- 关联项目(签约后)
  project_id INTEGER REFERENCES projects(id),
  
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  created_by INTEGER REFERENCES users(id)
);

-- 报价版本表
CREATE TABLE budget_quotations (
  id SERIAL PRIMARY KEY,
  budget_project_id INTEGER REFERENCES budget_projects(id),
  version INTEGER,                         -- 版本号
  quotation_date DATE,                     -- 报价日期
  amount DECIMAL(15,2),                    -- 报价金额
  currency VARCHAR(10) DEFAULT 'CNY',
  file_url TEXT,                           -- 报价文件
  status VARCHAR(20) DEFAULT 'draft',      -- draft/sent/accepted/rejected
  notes TEXT,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 附件表(工程基本情况附件)
CREATE TABLE budget_attachments (
  id SERIAL PRIMARY KEY,
  budget_project_id INTEGER REFERENCES budget_projects(id),
  file_name VARCHAR(255),
  file_url TEXT,
  file_type VARCHAR(50),  -- image/document/drawing
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- ============================================
-- 项目管理(签约后)
-- ============================================

-- 项目表新增字段
ALTER TABLE projects ADD COLUMN budget_project_id INTEGER REFERENCES budget_projects(id);
ALTER TABLE projects ADD COLUMN contract_code VARCHAR(50);        -- 合同编号
ALTER TABLE projects ADD COLUMN has_warranty BOOLEAN DEFAULT FALSE;
ALTER TABLE projects ADD COLUMN warranty_amount DECIMAL(15,2);
ALTER TABLE projects ADD COLUMN warranty_percent DECIMAL(5,2);
ALTER TABLE projects ADD COLUMN warranty_months INTEGER DEFAULT 12;
ALTER TABLE projects ADD COLUMN warranty_start_date DATE;
ALTER TABLE projects ADD COLUMN warranty_end_date DATE;
ALTER TABLE projects ADD COLUMN warranty_status VARCHAR(20) DEFAULT 'pending';

-- 工程量明细表(单价结算用)
CREATE TABLE project_work_items (
  id SERIAL PRIMARY KEY,
  project_id INTEGER REFERENCES projects(id),
  item_name VARCHAR(255),                  -- 项目内容
  unit VARCHAR(50),                        -- 单位
  unit_price DECIMAL(15,2),                -- 单价
  estimated_quantity DECIMAL(10,2),        -- 暂定工程量
  actual_quantity DECIMAL(10,2),           -- 实际工程量
  is_lump_sum BOOLEAN DEFAULT FALSE,       -- 是否总价包干
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 施工日志表
CREATE TABLE construction_logs (
  id SERIAL PRIMARY KEY,
  project_id INTEGER REFERENCES projects(id),
  log_date DATE NOT NULL,
  weather VARCHAR(50),
  recorded_by INTEGER REFERENCES users(id),
  work_content TEXT,
  next_plan TEXT,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 施工日志附件表
CREATE TABLE construction_log_photos (
  id SERIAL PRIMARY KEY,
  log_id INTEGER REFERENCES construction_logs(id),
  file_name VARCHAR(255),
  file_url TEXT,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 施工节点表
CREATE TABLE construction_milestones (
  id SERIAL PRIMARY KEY,
  project_id INTEGER REFERENCES projects(id),
  milestone_name VARCHAR(255),
  planned_date DATE,
  actual_date DATE,
  status VARCHAR(20) DEFAULT 'pending',    -- pending/completed
  notes TEXT,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 施工节点凭证表
CREATE TABLE milestone_evidence (
  id SERIAL PRIMARY KEY,
  milestone_id INTEGER REFERENCES construction_milestones(id),
  file_name VARCHAR(255),
  file_url TEXT,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- ============================================
-- 材料管理
-- ============================================

-- 项目材料汇总视图
CREATE VIEW project_materials_summary AS
SELECT 
  p.id as project_id,
  p.name as project_name,
  pr.product_id,
  pr.product_name,
  pr.unit,
  -- 预算量(从合同工程量)
  (SELECT estimated_quantity FROM project_work_items WHERE project_id = p.id AND product_id = pr.product_id LIMIT 1) as budget_quantity,
  -- 采购量
  SUM(pr.quantity) as purchase_quantity,
  -- 使用量(需要手动记录)
  0 as used_quantity,
  -- 均价
  AVG(pr.unit_price) as avg_unit_price,
  -- 总价
  SUM(pr.total_price) as total_price
FROM projects p
JOIN purchase_requests pr ON pr.project_id = p.id
GROUP BY p.id, pr.product_id, pr.product_name, pr.unit;

-- ============================================
-- 提醒机制
-- ============================================

-- 质保金提醒表
CREATE TABLE warranty_reminders (
  id SERIAL PRIMARY KEY,
  project_id INTEGER REFERENCES projects(id),
  reminder_date DATE,
  reminder_type VARCHAR(20),               -- 30days/7days/expire
  is_sent BOOLEAN DEFAULT FALSE,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 商谈提醒表
CREATE TABLE negotiation_reminders (
  id SERIAL PRIMARY KEY,
  budget_project_id INTEGER REFERENCES budget_projects(id),
  reminder_date DATE,
  days_since_last_quotation INTEGER,
  is_sent BOOLEAN DEFAULT FALSE,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

七、Tab内容与权限总结

Tab 内容 权限
基本信息 项目名称、客户、地点、勘察情况、照片、附件、客户要求 全部
合同详情 合同金额、付款节点、单价明细、质保金设置 全部
分包管理 分包商列表、分包金额、付款情况 全部
材料管理 材料汇总(预算量、采购量、使用量、均价、总价) 全部
施工节点 付款节点进度、重要节点完成情况、凭证上传 全部
施工日志 施工日志列表、照片、施工记录 全部(施工人员仅看自己)
财务信息 收款、支出、利润汇总 管理员+项目经理
质保金 质保金状态、到期提醒 管理员+项目经理

八、关键逻辑说明

8.1 居间费计算

固定金额: 居间费 = 输入金额
百分比:   居间费 = 合同金额 × 输入比例

示例:
- 固定金额: ¥5,000
- 百分比: 合同金额 ¥115,500 × 5% = ¥5,775

8.2 材料均价计算

同一材料多次采购:
采购1: 100米 × ¥80 = ¥8,000
采购2: 50米 × ¥90 = ¥4,500
采购3: 70米 × ¥85 = ¥5,950

均价 = (8000 + 4500 + 5950) / (100 + 50 + 70) = ¥83.41/米
总价 = 220米 × ¥83.41 = ¥18,450

8.3 总价包干 vs 单价结算

总价包干:
┌─────────────────────────────────────────────────────────────┐
│ 单价显示: "(总价包干)"                                       │
│ 暂定工程量: 可录入,仅供参考                                │
│ 实际工程量: 可录入,仅供参考                                │
│ 结算金额: = 合同金额(不变)                                │
│                                                             │
│ 如有变更: 通过"合同变更记录"调整金额                        │
└─────────────────────────────────────────────────────────────┘

单价结算:
┌─────────────────────────────────────────────────────────────┐
│ 单价显示: ¥15,000/km                                        │
│ 暂定工程量: 录入                                            │
│ 实际工程量: 录入                                            │
│ 结算金额: = Σ(单价 × 实际工程量)                           │
│                                                             │
│ 差异计算: 自动计算暂定 vs 实际的差异                       │
└─────────────────────────────────────────────────────────────┘

九、数据流转

预算报价 ──────────────────────────────────────> 项目管理

预算报价项目                    项目管理
┌──────────────────┐          ┌──────────────────┐
│ name             │ ──────>  │ name (可修改)    │
│ customer_id      │ ──────>  │ customer_id      │
│ location         │ ──────>  │ location         │
│ survey_notes     │ ──────>  │ (不显示)         │
│ survey_photos    │ ──────>  │ (不显示)         │
│ customer_requirements│ ──>  │ (不显示)         │
│ business_manager │ ──────>  │ (不显示)         │
│ intermediary     │ ──────>  │ (不显示)         │
│ intermediary_fee │ ──────>  │ (不显示)         │
│ quotation.amount │ ──────>  │ contract_amount  │
└──────────────────┘          └──────────────────┘

关联关系: projects.budget_project_id = budget_projects.id

方案完成时间: 2026-03-18