系统逻辑说明
给后续接手人员看的维护入口:先理解核心规则,再改页面或代码。
订单履约主线
这是奢沪第一期最重要的业务骨架。
1
客户提交需求选择快递、上门或送至场所;只填物品大类、件数、照片和可选说明。
2
完成交接快递、管家或合作场所接收物品,客户不负责细致拍照。
3
工厂录单细拍录单员核件、按标准位置细拍,整理报价和风险素材。
4
客户确认客服/报价员发报价;有风险先确认风险,不同意就转客服。
5
处理和质检工厂处理,质检同位置拍照;不合格返工或主管处理。
6
付款发回全部完成后提醒付款;未付款不能发货;顺丰签收后订单完成。
关键修改入口
改业务规则时不要只改页面,要同步后端规则和测试。
| 要改什么 | 主要位置 | 提醒 |
|---|---|---|
| 下单方式/件数/初始状态 | order-service.js / postgres-order-service.js / booking.js | 三种取送方式状态要和物流轨迹一致。 |
| 报价和风险 | order-service.js / quote.js / risk.js / orders.html | 客户不同意报价或风险必须转客服。 |
| 付款和发货 | order-service.js / payment.js | 未付款不能发货,B端月结要单独规则。 |
| 质检同位置拍照 | quality-service.js / quality.html / employee.js | 质检拍照前先看入厂同位置参考图。 |
| 权限和审计 | route-policy-service.js / admin-routes.js | 报价、付款、发货、余额、员工权限都要限制角色。 |
| 上线阻塞和资料分工 | deployment-service.js / deploy-check.js / generate-release-report.js | 后台部署中心和正式上线报告要保持同一套口径。 |
维护索引摘要
给接手人员看的“改哪里”地图。完整版本在
系统维护索引.json,总自检会检查它。
客户下单 客户小程序
客户只填取送方式、大类、件数、照片和可选说明;细拍、报价和风险判断在工厂和客服。
booking.js / order-service.js
报价和风险 客服/报价员
报价超时转客服;不同意报价可重报;不同意风险时不能继续对应处理。
quote.js / risk.js / support-center-service.js
付款和财务 财务
组合支付、余额、优惠券、退款和导出必须对齐;未付款不能发货。
payment.js / finance-export-service.js
员工手机端 岗位分流
管家、会所、录单、质检按角色进入;工人第一期不开放页面。
employee.js / staff-action-service.js
质检同位置拍照 质检主管
质检前调出入厂参考图,同位置补拍;案例图发布前必须授权和脱敏。
quality-service.js / files.html / cases.html
权限和审计 系统管理员
报价、退款、发货、余额、员工管理、测试签收都必须校验角色并留痕。
route-policy-service.js / logs.html
不能随便改的规则
客户不细分护理项目客户只提交大类、件数、照片和说明,报价判断在工厂/客服。
未付款不能发货除B端月结规则外,客户完成付款前不能出库。
风险不同意转客服不同意风险时不能继续处理,必须由客服介入说明。
管家代下单要授权每次代下单都需要客户确认授权,防止客户归属混乱。
照片宣传要授权案例候选图发布前必须完成客户授权和隐私脱敏。
修改后要检查
模块注册表新增页面、角色或业务模块后,先更新
系统模块注册表.md,再运行 node scripts/check-module-registry.js。维护索引改关键流程时同步
系统维护索引.json,说明入口文件、后端文件、后台页面和修改后检查。接口地图新增重要接口时同步
/api/admin/interface-map 背后的接口地图;高风险接口还要补权限策略。总自检运行
node scripts/check-all.js。正式上线报告改部署和外部接口后,重新生成正式上线门禁检查结果。
部署包交给其他人前重新生成并检查部署包。
当前上线阻塞
这些资料没齐前,只能内部演示或测试。
服务器域名
正式数据库
微信小程序密钥
微信支付
顺丰
企业微信
云存储