1. 系统定位

本系统用于跟踪光伏工程交付过程中的项目问题、责任链、处理进展、附件证据、状态闭环和人员协同情况。

核心目标：

•让现场问题有记录、有责任人、有进展、有闭环。

•让管理层看到项目风险、人员负载、超期问题和闭环效率。

•让现场人员在手机端 30 秒内完成一次进展更新。

2. 登录与账号

2.1 登录入口

普通用户登录：

https://gcgl.solarhz.com/login/

后台管理入口：

https://gcgl.solarhz.com/admin/

说明：

•普通用户请使用前台登录入口。

•后台管理入口仅系统管理员可用。

•非后台工作人员账号不能登录 /admin/。

2.2 修改密码

登录后点击右上角用户菜单，进入：

修改密码

建议：

•初次拿到账号后第一时间修改密码。

•不建议多人共用一个账号。

•不建议使用统一弱密码。

2.3 我的资料

入口：

右上角用户菜单 → 我的资料

可维护内容：

•头像

•姓名展示

•手机号

•部门

3. 角色与权限

系统支持一个人拥有多个角色。主角色用于默认身份展示，附加角色用于叠加权限。

权限规则简述：

•管理员、管理层可看全部。

•项目经理、运营主管可看自己负责或授权的项目。

•责任人、班长、兜底人默认可看责任链相关问题。

•问题责任链中的人默认拥有该问题所在项目的可见权限。

4. 首页驾驶舱

入口：

首页

主要用于管理层和项目管理人员快速查看整体情况。

包含内容：

•问题总览

•P0/P1 重点问题

•待确认问题

•超期问题

•项目风险排行

•时间维度分析

•闭环效率分析

常用操作：

•点击指标卡片进入对应问题筛选列表。

•点击项目风险排行中的项目进入项目页面。

•关注超期、受阻、待确认、P0/P1 问题。

5. 问题池

入口：

问题池

问题池用于集中查看所有问题。

5.1 常用筛选

可按以下条件筛选：

•项目

•问题类别

•状态

•优先级

•责任人

•靠谱兜底人

•关键词

•超期

•今日到期

•无截止时间

移动端筛选区域默认收起，点击展开后再筛选。

5.2 问题状态

常见状态：

•待分派

•正常推进

•受阻

•急需解决

•待确认

•已关闭

•已归档

建议状态使用方式：

•正常推进：问题正在按计划处理。

•受阻：需要外部协调或资源支持。

•急需解决：影响交付节点、验收、并网、回款等关键事项。

•待确认：现场已处理，等待管理层、甲方或相关人员确认。

•已关闭：问题已完成闭环。

6. 新增问题

入口：

新增问题

适用人员：

•系统管理员

•项目经理

•运营主管

6.1 必填重点

新增问题时建议重点填写：

•项目

•问题类别

•优先级

•责任人

•靠谱兜底人

•运营主管

•班长

•登记日期

•预计完成时间

•问题描述

•需要做什么

6.2 责任链

责任链包含：

•责任人

•靠谱兜底人

•运营主管

•班长

说明：

•选择项目后，运营主管和班长会优先读取项目档案中的信息。

•如果人员不存在，可通过“快速新增人员”补充人员档案。

•责任链人员会自动获得对应问题/项目的可见权限。

6.3 会议转任务（AI）

入口：

顶部导航 → 会议转任务

适用人员：

•系统管理员

推荐流程：

1. 点击“上传会议纪要”

2. 选择 Word 或 Markdown 文件，会议名称会默认读取文件名

3. 点击“上传并生成草稿”，等待 AI 解析完成

4. 在“会议任务草稿”中逐条编辑确认

5. 确认项目、责任人、截止日期、问题描述和行动要求

6. 点击“生成正式问题”，草稿进入问题池

支持文件：

•Word：.docx

•Markdown：.md

草稿确认重点：

•项目名称优先匹配系统已有项目；未匹配时需手动选择已有项目或快速新建项目。

•系统会在生成正式问题前提示可能重复的问题，避免重复建单。

•编辑草稿时可查看“对应原文摘要”，用于核对 AI 提取是否准确。

重新解析与替换文件：

•AI 重新解析：基于当前会议原文重新生成草稿，会覆盖该会议旧草稿。

•替换文件解析：上传新的会议文件，更新会议原文后重新生成草稿。

•同一会议文件只保留一份最新草稿列表，避免新旧草稿混在一起。

•覆盖的只是会议任务草稿和解析批次，已经生成到问题池的正式问题不会被删除。

等待提示：

•上传生成、重新解析、替换文件解析都会显示“AI 正在生成”提示。

•AI 解析可能需要几十秒，请不要关闭页面或重复点击按钮。

7. 问题详情

入口：

问题池 → 点击某个问题

问题详情页是现场使用最频繁的页面。

主要区域：

•问题基本信息

•责任链

•状态流转

•进展时间线

•新增进展

•评论与批注

7.1 新增进展

适用人员：

•责任人

•班长/现场负责人

•运营主管

•项目经理

•管理员

建议填写方式：

今天完成了什么 + 还剩什么 + 是否需要协调

示例：

今日完成支架整改 80%，剩余东侧 2 处明天上午处理；现场材料够用，暂无需协调。

如果受阻：

1. 勾选“是否受阻”

2. 填写“需要协调”

3. 写清楚需要谁协调、协调什么、影响什么节点

示例：

组件未到货，预计影响明日安装进度；需采购确认到货时间并同步现场。

7.2 上传附件

新增进展时可上传：

•照片

•视频

•PDF

•Word

•Excel

•压缩包

•其他文件

建议：

•现场优先拍照或录像留证。

•上传整改前、整改中、整改后的关键照片。

•视频适合记录设备运行、屋面情况、安全隐患等。

7.3 状态流转

问题详情页可进行状态流转。

常见操作：

•提交待确认

•标记正常推进

•标记受阻

•标记急需解决

•关闭问题

不同角色能操作的状态不同，以页面实际显示为准。

7.4 评论与批注

管理层和责任链相关人员可以添加评论。

使用建议：

•管理层用于提出要求、确认方向、补充风险判断。

•责任人用于补充说明，但现场推进情况优先写在“新增进展”中。

8. 项目管理

入口：

项目

项目页面用于查看每个项目的交付风险和问题分布。

8.1 项目列表

可查看：

•项目名称

•项目状态

•阶段

•运营主管

•班长

•开工时间

•风险情况

•未关闭问题数量

8.2 项目详情

项目详情包含：

•项目档案

•类别分布

•风险问题

•已关闭问题

•项目相关问题列表

说明：

•已关闭问题默认弱化/折叠，减少干扰。

•项目档案可在前台编辑，不需要跳转后台。

8.3 新增项目

适用人员：

•系统管理员

•项目经理

•运营主管

建议维护字段：

•项目名称

•业主/负责人

•施工单位

•项目地点

•装机容量

•当前阶段

•项目状态

•项目经理

•运营主管

•班长

•开工时间

•计划并网时间

•实际并网时间

•备注

9. 人员协同

入口：

人员

人员协同看板用于查看团队工作负载和协同风险。

重点关注：

•受阻待协调清单

•工作负载

•人员下钻

•近期活跃度

•超期未更新

•完成率

•已完成数量

点击人员可进入人员详情页。

10. 我的任务

入口：

我的任务

用于普通用户快速查看和处理与自己相关的问题。

包括：

•我负责的问题

•我兜底的问题

•我作为班长/现场负责人相关的问题

•我作为运营主管相关的问题

建议现场人员优先从“我的任务”进入工作。

11. 我的权限

入口：

右上角用户菜单 → 我的权限

可查看：

•当前账号

•当前角色

•附加角色

•是否可进入后台

•可访问项目

•可操作功能

说明：

•没有后台权限的用户不会显示后台入口。

•如果看不到某个项目或问题，优先检查人员档案和项目授权。

12. 后台管理

入口：

https://gcgl.solarhz.com/admin/

仅系统管理员使用。

常用后台模块：

•用户

•人员权限档案

•人员附加角色

•项目

•会议

•问题

•问题类别

•状态配置

•进展

•评论

•附件

12.1 用户与人员档案区别

用户 是登录账号。

人员权限档案 是业务身份和权限档案。

一个人要能正常使用系统，通常需要：

1. 有用户账号

2. 有人员权限档案

3. 人员档案关联正确角色和项目

12.2 启用普通用户登录

责任链人员默认可生成账号和人员档案，但不一定有可用密码。

如需让某人登录：

1. 后台进入“用户”

2. 找到该人员用户名

3. 设置密码

4. 确认 is_active 启用

5. 不要勾选 is_staff，除非要允许进入后台

建议为每个人设置独立临时密码，不建议统一弱密码。

13. 移动端使用建议

现场人员建议使用手机浏览器访问：

https://gcgl.solarhz.com/

推荐流程：

1. 打开“我的任务”

2. 点击需要更新的问题

3. 点击悬浮“+”或滚动到“新增进展”

4. 输入一句现场进展

5. 按需拍照/上传视频/上传文件

6. 如受阻，勾选“是否受阻”并填写协调事项

7. 点击“提交进展”

30 秒录入模板：

今日完成：……
剩余事项：……
是否受阻：否/是，需……协调

14. 数据导入与备份

系统支持从 Excel 导入会议问题跟踪表。

线上数据库已配置 PostgreSQL 自动备份：

•每天凌晨 02:30 自动备份

•默认保留 30 天

•备份路径：/opt/backups/delivery-tracker/postgres

手动备份命令：

sudo /opt/delivery-tracker/scripts/ops-backup-now.sh

15. 常见问题

15.1 普通用户不能登录后台

这是正常设计。

后台仅系统管理员使用。普通用户请访问：

https://gcgl.solarhz.com/login/

15.2 看不到项目或问题

请检查：

•用户是否有人员权限档案

•姓名是否与问题责任链中的姓名一致

•是否被授权到项目

•是否是责任人、兜底人、运营主管或班长

15.3 上传附件失败

请检查：

•文件是否过大

•网络是否稳定

•是否为支持的文件类型

•是否有该问题的操作权限

15.4 提交进展后状态没有变化

只有勾选“是否受阻”时，系统会自动把问题标记为“受阻”。

其他状态请使用问题详情页的状态流转按钮。

15.5 已关闭问题在哪里

项目详情页中，已关闭问题会弱化显示并默认折叠。

问题池中也可以通过状态筛选查看已关闭问题。

15.6 会议转任务提示 AI 服务暂时无法连接

请检查：

•本地预览服务是否使用可联网权限启动。

•服务器环境变量 DEEPSEEK_API_KEY 是否已配置。

•服务器是否能访问 DeepSeek API。

•会议文件内容是否为空，或文件格式是否为支持的 .docx / .md。

16. 推荐日常管理动作

每日：

•查看首页驾驶舱

•处理 P0/P1、受阻、超期、待确认问题

•检查现场人员是否有进展更新

每周：

•查看项目风险排行

•查看人员协同看板

•清理长期未更新问题

•确认已完成问题是否关闭

每次重大导入或批量修改前：

sudo /opt/delivery-tracker/scripts/ops-backup-now.sh

17. 运维入口

服务器状态检查：

sudo /opt/delivery-tracker/scripts/ops-status.sh

查看日志：

sudo LINES=200 /opt/delivery-tracker/scripts/ops-logs.sh

立即备份：

sudo /opt/delivery-tracker/scripts/ops-backup-now.sh

说明：

•普通业务人员不需要使用运维命令。

•运维命令仅管理员或服务器维护人员使用。