工程管家云系统使用说明书

本说明书用于指导公司管理员、工程员工、财务人员和平台总管理员使用系统。系统适合工程安装、维修维保、水电、强电、空调安装、监控门禁、综合布线等工程服务公司管理项目、派工、进度、验收、开票、收款、售后服务、项目附件和员工提成。

系统地址https://yt.phee.cn

平台管理入口https://yt.phee.cn/?admin=1

当前版本重点多公司账号独立数据

适用对象工程安装和维修维保公司

老板先看首页看板、新建项目、派工验收、财务和提成。

员工先看登录后确认接单、上报进度、上传照片、申请完工。

财务先看项目验收后开票、登记收款、设置下次催款日期。

管理员先看注册公司、人员权限、客户资料、备份和平台管理。

1. 系统概览

系统采用一个平台、多家公司注册使用的方式。每家公司有独立公司账号、独立员工、独立客户、独立项目数据。A 公司看不到 B 公司的项目，B 公司也看不到 A 公司的员工和客户。

模块	用途
项目管理	新建工程项目或售后服务单，跟进施工、验收、作废、恢复。
员工派工	给员工分配任务，员工可确认接单、上报进度、上传完工照片。
财务管理	登记开票、收款、催款日期、项目成本、营销费用、利润。
提成统计	按员工和时间段统计提成，并列出每笔提成来源项目。
客户管理	维护客户名称、联系人、电话和地址。
平台管理	查看注册公司数量，管理公司名称、负责人、密码和删除公司。

2. 账号与登录

先分清三类账号：公司账号用于进入公司，员工账号用于日常操作，平台账号用于管理所有客户公司。

2.1 公司注册

打开 https://yt.phee.cn。
点击“注册公司”。
填写公司名称、公司账号、密码、负责人姓名。
注册成功后，系统会自动创建该公司的管理员账号。

重要：公司账号是全平台唯一的。例如 yuante 被注册后，其他公司不能再注册同名公司账号。

2.2 登录方式

登录对象	登录账号	说明
公司管理员	公司账号	例如 `yuante`，登录后进入公司系统。
员工	员工登录号	员工登录号与真实姓名分开，例如登录号 `zhangsan01`，员工名字显示为“张三”。
平台总管理员	平台账号	从 `https://yt.phee.cn/?admin=1` 进入。

2.3 员工登录号规则

必须英文开头。
只能包含英文、数字、下划线。
长度 3 到 32 位。
全平台唯一，其他公司用过的员工登录号不能再用。

建议格式：zhangsan01、wanggong、li_tech。

3. 角色权限

不同角色看到的按钮和数据不一样。老板管全局，员工管现场，财务管开票收款，平台管理员管客户公司。

角色	能做什么	不能做什么
管理层/老板	新建项目、派工、验收、管理人员、管理客户、查看财务统计和提成统计、恢复/作废项目。	平台总管理功能需要平台管理员入口。
工程部员工	查看分配给自己的任务、确认接单、上报进度、上传现场照片、申请完工。	默认看不到财务金额和提成，除非管理员打开可见开关。
财务	查看项目进度、登记开票、登记收款、查看财务统计和提成统计。	通常不负责现场进度上报。
平台总管理员	查看所有注册公司、重置公司密码、删除公司。	不直接参与具体公司项目施工流程。

4. 新建项目

管理层点击首页“新建”进入项目创建页。系统支持两种模式：

项目模式	适用场景	财务流程
普通工程	强电工程、弱电工程、水电工程、空调工程、设备安装、综合布线等工程项目。	需要开票、收款、统计利润和提成。
售后服务	维修、调试、返修、客户回访、故障处理。	不需要开票和收款，验收后直接完成。

4.1 普通工程需要填写

项目名称、客户、联系人、联系电话、施工地址。
合同金额、员工提成、项目成本、营销费用、营销费用备注。
计划完工日期、项目类型、特殊要求/备注。
备注照片、项目附件、施工人员、提成分配比例。

4.2 项目类型可自定义

项目类型既可以从下拉框选择，也可以手动输入。新类型保存过项目后，以后会自动出现在项目类型筛选里。

4.3 营销费用备注

营销费用不只是填金额，还可以写清楚具体是什么费用，例如客户招待、礼品、介绍费、活动费用等，便于后续查账。

5. 项目流程

5.1 普通工程流程

1待接单：管理层新建项目并派工。

2施工中：工程部确认接单并上报施工进度。

3待验收：工程部申请完工验收。

4待开票：管理层验收通过，通知财务开票。

5待收款：财务登记发票后等待收款。

6已完成：款项结清后项目完成。

5.2 售后服务流程

售后服务流程为：待接单 → 施工中 → 待验收 → 已完成。售后服务不进入开票和收款流程。

老板看状态
项目卡片会显示当前状态，方便知道下一步该谁处理。

员工做现场
员工主要负责接单、上报进度、上传照片和申请完工。

财务盯回款
验收后进入开票收款，未结清项目会保留催款提醒。

5.3 回收站

管理层可以将项目删除并移动到回收站。回收站中的项目可以恢复，也可以彻底删除。彻底删除后无法从系统内直接找回，只能从备份恢复。

6. 照片和附件

6.1 员工完工照片

员工上报进度或申请完工时，可以拍照上传。照片会在手机浏览器里自动压缩到约 200KB 后上传，管理层打开项目后可以查看。

6.2 新建项目备注照片

在“特殊要求 / 备注”下面可以上传备注照片，例如现场情况、客户要求、故障点位。照片会自动压缩到约 350KB，清楚够看，又不容易占满服务器空间。

6.3 项目附件

项目附件支持报价单、合同、现场照片、PDF、Word、Excel 等。图片会压缩到约 350KB；PDF、Word、Excel 保持原文件上传。

文件类型	系统处理方式
照片/JPG/PNG	自动压缩后上传，可预览。
PDF	原文件上传，可预览。
Word/Excel	原文件上传，点击后下载打开。

7. 财务统计

财务统计用于查看销售额、收款、应收款、项目成本、营销费用、员工提成和预估利润。财务统计下方的项目明细可以点击进入项目详情。

7.1 财务人员常用操作

进入项目详情。
项目验收通过后，点击开票操作。
客户付款后，登记本次收款金额和收款备注。
如果未结清，可以设置下次付款日期、预计金额和催款备注。

注意：员工默认看不到财务金额和提成。只有管理层打开“工程部可见提成金额”后，工程部才可以看到相关提成信息。

8. 提成统计

提成统计可以按员工和时间段查看金额，并显示这些提成来自哪些项目。

选择员工。
选择开始日期和结束日期。
查看筛选后提成总额。
查看来源项目、客户、完成/结算日期、项目总提成、员工分配比例和个人提成。
点击来源项目可进入项目详情。

8.1 多人项目如何算提成

多人项目按项目里设置的提成比例分配。如果没有设置比例，则按人数平均分配。

8.2 员工能不能看提成

人员管理里有“工程部可见提成金额”开关。关闭时，员工看不到项目提成，也看不到提成统计入口；开启后，员工可以看到自己的提成信息。

9. 人员管理

管理层可以进入“人员管理”新增、编辑、删除员工，也可以控制工程部是否可见提成金额。

9.1 新增人员字段

字段	说明
登录号	员工登录系统用的英文/数字账号，例如 `zhangsan01`。
员工名字	真实姓名，用于派工、项目显示、提成统计。
职位/头衔	例如施工队长、施工助手、财务。
角色权限	管理层、工程部、财务组。
员工级别	工程部员工可设置级别，用于默认提成比例。
登录密码	该员工登录系统时使用。

建议：登录号不要用中文姓名。真实姓名可以重复，但登录号必须唯一，便于多家公司共同使用平台时不冲突。

老板
建议保留一个管理层账号，负责派工、验收、人员和客户管理。

工程部
主要负责接单、进度、照片和完工申请，金额默认可隐藏。

财务组
主要负责发票、回款、催款日期、财务统计和提成统计。

10. 客户管理

客户管理用于维护客户资料，包括客户名称、联系人、电话、地址。新建项目时也可以手动输入新客户，保存项目后系统会自动把新客户加入客户列表。

常用操作

添加新客户。
编辑客户联系人和电话。
删除不再使用的客户。
新建项目时从客户下拉框直接选择。

使用技巧：客户名称尽量统一，例如不要一会儿写“嘉兴某厂”，一会儿写“某制造有限公司”，否则后续筛选和统计会分散。

11. 平台管理

平台管理用于系统拥有者查看和管理所有注册公司。

入口	`https://yt.phee.cn/?admin=1`
平台账号	`admin`
平台密码	由系统拥有者保管，不建议写入公开说明书。

平台管理可做什么

查看注册公司数量。
查看公司账号、公司名称、负责人、注册时间。
查看每家公司项目数、员工数、客户数。
修改公司名称和负责人。
重置公司账号密码。
删除公司及其项目、员工、客户数据。

建议流程：新客户注册后，先确认公司名称、负责人、套餐、到期时间和用户额度，再让客户正式录入真实项目。

危险操作：删除公司会删除该公司项目、员工、客户数据。执行前必须确认已备份。

12. 备份与维护

备份的目的不是“有文件就行”，而是系统出问题时能恢复数据库、附件和代码。

12.1 自动备份

当前系统已经设置每天凌晨 2 点从 VPS 自动备份到本机。备份内容包括：

数据库 yuantong.db
后端代码 server.mjs
前端首页 index.html
上传文件 uploads/
nginx 配置

本机备份目录：/Users/jordan/YuantongVpsBackups

12.2 商业化建议

如果只是少量客户试用，目前服务器可以先跑。如果要卖到几十家、上百家，建议逐步升级：

服务器升级到 4 核 8GB 内存以上。
数据库从 SQLite 迁移到 PostgreSQL。
照片和附件迁移到对象存储，例如阿里云 OSS。
密码改成加密存储。
增加服务器监控、异常报警、异地备份和恢复演练。

13. 常见问题

员工为什么看不到提成统计？

因为“人员管理”里的“工程部可见提成金额”关闭了。开启后，员工才能看到提成金额和提成统计。

员工登录号和员工名字有什么区别？

登录号用于登录系统，必须英文/数字且全平台唯一；员工名字用于项目显示、派工和提成统计，可以是真实中文姓名。

售后服务为什么没有开票和收款？

售后服务单用于维修、调试、返修、客户回访等，不进入财务开票收款流程。

上传照片很大怎么办？

系统会自动压缩照片。员工完工照片约 200KB；新建项目备注照片和附件照片约 350KB。