操作指南

用于客户 UAT、内部培训和日常使用。建议管理员先完成账号、角色和业务员配置，再开始导入或录入项目数据。

适用页面：登录后首页 建议浏览器：Chrome / Edge 当前版本：V2.0 最后更新：2026-05-12

1. 快速开始

第一步：登录使用管理员分配的账号密码登录系统。登录过期时，系统会自动返回登录页。
第二步：检查用户进入“用户管理”，确认业务员账号、角色、在职状态和所属公司主体。
第三步：录入业务先维护客户，再创建项目；也可以通过 Excel 批量导入项目台账。
如果页面显示旧内容或样式异常，请按 Ctrl + F5 强制刷新。

2. 首页总览

登录后的首页是日常工作的总入口。建议先看顶部统计和提醒，再进入客户、项目、补录、导入导出等具体模块处理业务。

顶部操作区显示当前登录人、版本号和“操作指南”入口；右侧可退出登录，避免公用电脑保留登录状态。
数据看板区汇总客户、项目、合同、验收、已付、未付等核心指标，适合管理层快速判断业务规模和回款压力。
业务提醒区展示合同即将到期、待跟进催款、关键异常等事项，优先处理红色或高风险提示。

推荐使用顺序

  1. 先确认当前账号角色是否正确，避免因权限不同导致看不到数据。
  2. 查看首页统计是否与预期一致，发现差异时优先检查筛选条件、业务员归属和客户层级。
  3. 处理提醒事项后，再进入项目台账补录收款、上传附件或导出报表。
管理员看到的是全量视角；业务员看到的是本人名下数据。培训客户时，可以用两个角色分别演示权限隔离效果。

3. 账号与权限

角色典型职责数据范围
管理员配置系统、管理角色用户、查看催款报表和操作日志。全量数据。
经理查看项目和客户，协助管理业务员与日常台账。按角色权限控制。
业务员维护共享客户、本人名下项目、收款和附件。客户共享可见；项目、催款、导出等按本人名下项目控制。
离职业务员不要直接删除。请先使用“离职交接”，把客户和项目转给接收人，再停用或删除账号。

4. 客户管理

  1. 客户层级建议保持为：工程局 → 客户主体 → 分公司。
  2. 客户资料为共享可见。业务员可以基于共享客户新建自己的项目，项目归属独立于客户创建人。
  3. 公司显示名由“客户主体 / 分公司”自动拼接，通常不需要手工修改。
  4. 管理员可代业务员维护共享客户和附件；业务员登录后仍可看到自己名下项目及对应附件资料。
  5. 业务员编辑或删除“非自建且已关联项目”的客户时，系统会提示联系管理员处理。
  6. 删除客户会同步删除客户下项目、收款和附件记录，请谨慎操作。
示例：工程局“中建三局”，客户主体“中建三局第三建设工程有限责任公司”，分公司“浙江分公司”。

5. 项目台账

常用操作

  • 点击“新增项目”录入项目名称、客户、项目内容、合同金额、验收金额和项目经理信息。
  • “所属客户”支持在下拉层内搜索，可按工程局、客户主体、分公司、联系人快速定位；编辑项目时也支持更换所属客户，保存后立即生效。
  • 业务类型现支持门禁、收验货、零星材料、智慧工地、监控、挤塑板，逻辑口径保持一致。
  • 新增项目阶段默认隐藏“付款记录”和“分期单据上传”模块；项目创建成功后再进入编辑或补录继续维护。
  • 合同到期提醒根据系统配置中的提醒天数计算，也可对单个项目关闭提醒。
  • 搜索框支持按项目、客户、工程局、联系人等关键词筛选；客户主体与项目名称列间距已收紧，列表更便于扫描。

金额口径

字段说明
合同总金额由各业务分类合同金额自动汇总。
总验收金额由各业务分类验收金额汇总，也会随验收单附件金额变更实时刷新。
未付款按“结算金额 - 已付金额”计算，最低为 0。
已付比例优先按结算金额计算；没有结算金额时按合同金额计算。

6. 补录、收款与附件

  1. 在项目行点击“补录”，可追加收款、补充合同、补充协议、发票、验收单、月结单和催款记录。
  2. 项目台账三角形展开后的附件明细中，发票、验收单、月结单支持直接修改金额并确认；修改后会立刻刷新当前项目金额。
  3. 在预览区或编辑弹窗删除附件后，项目金额会立即重算并回填，不需要再点击“保存”。
  4. 附件名称支持直接点击下载；管理员代上传的附件，所属业务员登录后也能看到并下载。
  5. 支持格式：Word、PDF、图片、Excel（验收单支持 xls/xlsx）。单个文件默认不超过 50MB。
  6. 删除附件前会弹出二次确认；同一项目、同一单据类型、同文件名、同金额且文件大小一致时，系统会自动忽略重复上传。
多文件上传时，金额只会计入第一个文件，后续文件作为同批附件保存，避免重复累加金额。

7. Excel 导入与导出

导入要求

  • 必须选择业务员，导入的数据会归属该业务员。
  • Excel 至少包含“项目名称”，并包含“工程局”或“客户主体/公司”相关列。
  • 合并单元格或空白工程局/公司列会自动继承上一条有效数据。
  • 导入前建议先用少量数据试导，确认层级和金额口径正确后再批量导入。

导出说明

  • “项目台账”导出当前账号可见范围内的项目。
  • 项目管理页可按客户导出单客户项目台账。
  • 催款报表导出仅管理员可用。

8. 催款报表

管理员可查看全部催款记录，并按业务员、工程局、关键词、日期范围筛选。普通业务员可在项目补录中维护自己项目的催款详情。

建议每次电话或微信催款后补录一条最新催款记录，便于后续对账和管理层跟进。

9. 系统配置

  • 合同到期提醒天数：控制首页“合同即将到期”列表范围。
  • 通知开关：可分别开启群通知总开关、合同到期推送、催款跟进推送和服务器定时推送。
  • Bot Webhook：支持企业微信、飞书和自定义 Bot，必须使用 HTTPS 地址；未填写时只在页面展示提醒。
  • 角色权限：可按“查看/编辑项目、查看/编辑客户、用户管理、角色管理、日志查看”等权限组合。
  • 操作日志：记录登录、创建、修改、删除、导入等关键操作。

10. 常见问题

看不到客户或项目？

业务员可查看共享客户，但项目、附件、催款和导出仍按本人名下项目控制。若共享客户下新建项目仍提示无权限，请退出后重新登录一次再试。

客户管理搜索框自动带入用户名？

系统已关闭该搜索框的自动填充；如果浏览器仍带入历史账号名，请清空一次自动填充记录或按 Ctrl + F5 强刷。

附件怎么下载？

在项目附件列表中直接点击附件名称即可下载；若提示登录，请先确认当前登录状态是否过期。

上传失败？

请检查文件格式、大小和金额是否符合要求。大文件建议压缩后再上传。

登录过期？

系统会自动清理登录状态并返回登录页，重新登录即可。

11. 历史更新记录

这里记录每次正式迭代的版本号、更新时间和主要变更，方便管理员培训、客户验收和后续问题追溯。

版本更新时间更新内容
V2.02026-05-12
  • 修复共享客户下新建项目权限、管理员代上传附件业务员不可见、附件下载登录校验等正式服权限问题。
  • 发票、验收单、月结单支持在项目台账展开预览和编辑弹窗中直接改金额；删附件或改金额后，项目金额立即刷新，无需再点“保存”。
  • 新增业务类型“挤塑板”；新增项目时隐藏付款记录和分期单据上传，项目创建成功后再补录；编辑项目支持更换所属客户并立即生效。
  • 优化项目台账与附件交互：收紧客户主体与项目名称列间距、修复客户管理搜索框自动带入用户名、附件名称直接下载、删除附件增加二次确认。
  • 正式环境启用 HTTPS 域名 11021504.xyz / www.11021504.xyz / zj.11021504.xyz，并将派单系统切到 pd.11021504.xyz；登录页新增派单入口，首页底部新增备案号，证书自动续签已接入。
V1.3.02026-05-11
  • 新增项目“所属客户”升级为下拉内搜索，支持按工程局、客户主体、分公司、联系人快速定位，并按工程局自然顺序排序。
  • 刷新页面会停留在当前功能页，普通业务员刷新时不再闪现无权限菜单。
  • 客户管理补齐“创建人”展示；业务员编辑或删除非自建且已关联项目的客户时，会提示联系管理员处理。
V1.2.162026-05-11
  • 客户资料改为共享可见，多个业务员可共用同一客户。
  • 项目归属改为按项目业务员管理，项目台账、项目管理、催款和导出统一按项目业务员筛选。
  • 项目新增和编辑时可独立选择项目所属业务员，不再受客户创建人限制。
V1.2.152026-05-11
  • 项目台账列表恢复显示“已验收金额”列。
V1.2.142026-05-11
  • 附件上传大小上限由 20MB 调整为 50MB。
  • 前端上传校验、后端服务限制和网关限制同步更新，避免大文件提示不一致。
V1.2.132026-05-11
  • 修复新增项目上传超过 20MB 附件失败后，重复点击保存会重复新增项目的问题。
  • 项目创建前先校验待上传文件大小，超限时不会写入项目记录。
  • 项目管理兼容历史客户层级，项目台账新增的项目会同步出现在项目管理。
V1.2.122026-05-11
  • 以 V1.2.8 为基线恢复「基础信息维护」，保留服务公司维护入口。
  • 补回项目台账搜索框防自动填充，避免账号名误带入筛选。
  • 修复监控分类金额映射，并统一项目管理与项目台账未付款统计口径。
  • 新增项目服务公司改为必选，发票金额保持蓝色只读自动累计。
V1.2.82026-05-07
  • 新增「基础信息维护」菜单，支持服务公司的新增、编辑、删除。
  • 已关联项目的服务公司自动隐藏编辑和删除按钮，防止误操作。
  • 台账列表和编辑页的服务公司下拉菜单改为从数据库动态加载全部服务公司。
V1.2.72026-05-06
  • 项目台账编辑页面允许修改初始发票金额。
  • 项目台账编辑页面金额汇总处隐藏发票号码及对应文本框。
V1.2.62026-04-30
  • 未收款统计统一为按项目未收款求和，避免跨项目抵消。
  • 编辑页显示初始已收、流水合计、当前总已收，收款口径更清楚。
  • 编辑和补录发票支持多文件逐张填写发票金额与发票号码，每张发票独立入账。
  • 同步监控业务、服务公司、补充协议金额、验收金额、发票号码等字段与前后端逻辑。
V1.2.5 2026-04-28
  • 项目新增“当前启用业务分类”记忆，反选保存后再次编辑保持隐藏状态。
  • 升级后仍兼容历史项目：未保存过启用分类的项目继续按日期和金额自动展开。
V1.2.4 2026-04-28
  • 保存项目时，未选中的业务分类会被强制清空日期和金额。
  • 后端同步校验当前启用分类，防止隐藏字段残留旧值导致再次编辑时恢复。
V1.2.3 2026-04-28
  • 编辑已有项目时，附件不再强制展开业务分类字段。
  • 反选分类并保存后，再次打开会保持隐藏状态；附件仍在已上传文件区正常显示。
V1.2.2 2026-04-28
  • 业务分类按钮支持再次点击取消，取消后隐藏并清空该分类日期和金额。
  • 编辑已有项目时，自动展开判断不再使用已删除的“已验收金额”历史字段。
V1.2.1 2026-04-28
  • 为项目台账静态资源增加版本号，避免浏览器缓存旧脚本影响新增项目分类展开效果。
  • 将“+收验货 / +零星材料 / +智慧工地”写入按钮文本，保证加号提示稳定显示。
V1.2 2026-04-28
  • 新增项目默认只显示“门禁”分类，点击其他分类按钮后再展开对应日期和金额字段。
  • 编辑已有项目时，系统会根据已有数据自动展开对应业务分类。
  • 项目编辑页移除四项分类“已验收金额”，减少误读和重复信息。
  • 项目台账列表移除“已验收总金额”列，列表更简洁。
V1.1 2026-04-27
  • 项目编辑和补录页面移除“补充合同”新增入口，页面更简洁。
  • 补录发票附件时新增“发票号码”输入项。
  • 上传发票附件后，系统同步更新项目发票金额和发票号码。
  • 删除发票附件后，系统同步扣减项目发票金额。
  • 优化单据汇总显示，减少无效分类干扰。
V1.0 2026-04-25 客户维护、项目台账、收款补录、附件上传、Excel 导入导出、权限管理、操作日志、企业微信/飞书通知等核心功能上线。
后续每次发布都会在这里追加记录；登录后的更新弹窗只提示当次重点变化。

12. UAT 验收清单

管理员能登录并创建业务员账号。
业务员可查看共享客户，并能在共享客户下新建本人项目。
客户层级显示为工程局、客户主体、分公司。
新增项目后金额、状态、项目经理信息正确，付款记录和分期单据在创建后再补录。
发票、验收单、月结单改金额后会立即刷新项目金额。
上传和下载附件正常，管理员代传附件业务员可见，删除前会二次确认。
Excel 导入结果与模板数据一致，默认分类支持挤塑板等业务类型。
正式域名、备案号、派单入口和证书访问正常。
正式使用前，请确认数据库已配置定时备份，并保存管理员账号密码。
中建客户维护系统操作指南