内部知识库 · 请登录后查看
整理了平台四个端的入口和账号,以及用户下单、商户入驻、师傅接单三条主要流程的操作步骤,供培训和日常查阅。
系统一共 4 个端,各管各的事,合起来完成一单家政服务。下面的色块代表操作角色,全文都用它标注。
运营方用,管全局
家政公司 / 门店用,管自己店铺
客户用,浏览、下单、评价
服务人员用,接单、上门、提现
每一步都写清了谁来操作、在哪里点、具体做什么,可以对着系统边看边讲。流程四是「下单之后单子去哪了」的完整机制,接单相关的问题先看它。
① 两条出单线对比
| 对比项 | 线 A · 商城直购 → 抢单池 | 线 B · 发布需求 → 报价池 |
|---|---|---|
| 怎么发起 | 用户在服务列表选项目 → 立即购买 → 支付 | 用户点「发布需求」,填服务类型 / 时间 / 地址 / 预算 |
| 数据落在哪张表 | eb_service_order 服务订单表 | eb_service_need 需求表 |
| 师傅在哪看到 | 员工端 → 首页 → 接单中心 | 员工端 → 需求订单 tab |
| 师傅做什么 | 点「我要接单」,先到先得 | 点「我要报价」,同一条需求可多人报价 |
| 怎么变成正式订单 | 抢单成功即成为该师傅的订单 | 用户在「已报价」里挑一位师傅 → 下单支付 → 生成订单 |
| 派给谁 | 抢到单的那位师傅 | 直接指派给被选中的师傅,不进抢单池 |
| 适合的场景 | 标准化服务:保洁、清洗、维修,明码标价 | 非标准化需求:需上门评估、议价 |
② 师傅端几个页面分别看什么(最容易搞混)
| 页面 | 干什么 | 数据来源 |
|---|---|---|
| 首页 · 接单中心 | 抢公开订单(按钮:我要接单) | eb_service_order:status=10 且未指派师傅 |
| 首页 · 今日待处理 | 看已经属于自己的单,上门签到 / 完成 | eb_service_order:service_staff_id = 自己 |
| 需求订单(tab) | 给用户需求报价(按钮:我要报价) | eb_service_need:status=10 待接单 |
| 订单(tab) | 查全部服务订单、翻历史、看详情 | 自己的订单(进行中 + 已完成) |
| 我的 · 收入统计 | 看佣金明细、发起提现 | 佣金流水与提现记录 |
③ 完整实操步骤(从下单到拿到佣金)
④ 为什么接单中心是空的:抢单池的六个硬条件
订单要出现在某个师傅的接单中心,必须同时满足下面全部条件(缺一条就看不到):
| 条件 | 要求 | 在哪里设置 / 由谁决定 |
|---|---|---|
| 订单状态 | 必须是 10 待接单 | 用户付款后系统自动流转 |
| 预约时间 | 必须是未来的时间(过期单自动消失) | 用户下单时选 |
| 服务工作日 | 预约那天要落在师傅勾选的「服务工作日」里 | 员工端 → 我的 → 接单时间 edit_time |
| 服务项目 | 订单的项目必须在师傅已关联的服务项目里 | 员工端 → 我的 → 服务项目 edit_item(后台也可配) |
| 城市 | 订单城市 = 师傅绑定的城市 | 师傅资料 / 后台 |
| 距离 | 下单地址到师傅接单位置的距离 ≤ 师傅的服务半径 | 员工端 → 我的 → 接单位置 edit_place |
| 门店归属 | 订单属于平台(无门店)或等于师傅所属门店 | 订单来源决定 |
⑤ 状态值速查
| 数值 | 服务订单状态 | 由什么触发 |
|---|---|---|
| 0 | 待付款 | 用户提交订单未支付 |
| 5 | 待预约 | 已付款但未选预约时间 |
| 10 | 待接单(在抢单池里) | 付款完成 + 有预约时间 |
| 20 | 已接单 | 师傅抢单成功,或被平台 / 门店指派 |
| 25 | 服务中 | 师傅上门签到 |
| 30 | 已完成(待评价) | 师傅提交订单完成 |
| 40 | 已结单 | 财务结算完成 |
| -1 / -10 / -20 | 已取消 / 退款申请 / 已退款 | 用户取消或发起售后 |
| 数值 | 需求状态(报价池) | 说明 |
|---|---|---|
| 0 | 待审核 | 刚提交,平台可审核 |
| 10 | 待接单 | 师傅可见、可报价(对应“待确认”) |
| 20 | 已接单 | 用户已选中某位师傅并下单 |
| -10 / -1 | 未通过 / 已取消 | 平台驳回或用户取消 |
| 报价状态 | 10 待选 · 20 已接单 · 30 已落选 | 同一需求可收到多份报价 |
把上面三条主线流程按层级整理成脑图。给同事讲解时一层层点开就行(流程四是机制说明,见上一节第四个页签)。
技术相关:系统分层、域名、服务器和本地环境。
| 域名 | 是什么 | 后端 / 目录 |
|---|---|---|
| back.birjanan.com | 平台总后台 | 8080 · /www/wwwroot/BackPlatform |
| merchent.birjanan.com | 商户端后台 | 8080 · /www/wwwroot/MerchantsPlatform |
| jzadmini.birjanan.com | 后台 API | → 127.0.0.1:8080 |
| jzfront.birjanan.com | 小程序 API | → 127.0.0.1:8081 |
| h5.birjanan.com | H5 商城 | /www/wwwroot/h5/web |
| info.birjanan.com | 本知识库 | /www/wwwroot/InfoSite |
service_user(34页) service_staff(21页) company(20页) admin(18页)51393,root + 密钥登录https://8.130.210.87:4560/birjan完整档案见下方「服务器 & 宝塔面板 信息档案」。
mer_uniapp → 发行 → 小程序unpackage/dist/build/mp-weixinjzfront.birjanan.com 需在合法域名列表E:\xiangmu)start-all.ps1 / 停止 stop-all.ps1config/app.js 域名为 http://127.0.0.1:8081服务器 & 宝塔面板 信息档案
以下为 2026-10-12 从服务器实测采集的结果,供运维、交接和故障排查使用。
| 服务器 | 值 | 说明 |
|---|---|---|
| 公网 IP | 8.130.210.87 | 家政业务正式环境 |
| 内网 IP | 172.26.168.241 | 阿里云 ECS |
| 操作系统 | Alibaba Cloud Linux 4 | 内核 6.6.102-5.3.1.alnx4 |
| 配置 | 4 核 8G | 系统盘 40G(已用约 18G,49%) |
| SSH 端口 | 51393 | 非默认端口,仅 root + 密钥登录 |
| SSH 私钥 | ~/.ssh/birjan_ed25519 | 另一把 birjan_aliyun_rsa 无效 |
ssh -i ~/.ssh/birjan_ed25519 -p 51393 root@8.130.210.87| 宝塔面板 | 值 | 说明 |
|---|---|---|
| 面板地址 | https://8.130.210.87:4560/birjan | 端口 4560,安全入口 /birjan,已开 SSL(必须用 https) |
| 用户名 | birjananadmin | 面板密码为不可逆哈希,无法找回 |
| 版本 | 阿里云宝塔联合定制版 13.1.0 | 绑定阿里云账号 200739289 |
| 网站根目录 | /www/wwwroot/ | 备份目录 /www/backup/ |
| 站点配置 | /www/server/panel/vhost/nginx/ | 每个域名一个 conf |
| 访问异常 | 不带浏览器 UA 或路径不全时会故意返回 404 | 必须用完整地址访问 |
bt 14 查看面板地址与用户名(密码打码显示)bt 5 修改面板密码bt 6 修改面板用户名bt 10 清除面板登录失败限制(被锁定时用)bt 1 重启面板| 后端服务(Java) | 启动包 / 端口 | 作用 |
|---|---|---|
| 后台接口 | /www/wwwroot/Administrator/mxx-admin.jar · 8080 | 两个管理后台的 API(/api/admin/) |
| 小程序接口 | /www/wwwroot/Front/mxx-front.jar · 8081 | 小程序 + 员工端 API(/api/front/) |
| 运行 JDK | /www/server/java/jdk1.8.0_371 | 由宝塔「Java 项目」管理器托管 |
| 启动脚本 | /var/tmp/springboot/vhost/scripts/mxx-admin.sh | 另一个为 mxx-front.sh |
| PID 文件 | /var/tmp/springboot/vhost/pids/ | mxx-admin.pid / mxx-front.pid |
| 运行日志 | /www/wwwlogs/java/springboot/mxx-*.log | 另有 /www/wwwroot/{Administrator,Front}/crmeb_log/ |
| 域名 / 站点 | 站点目录 | 说明 |
|---|---|---|
| back.birjanan.com | /www/wwwroot/BackPlatform/dist | 平台总后台 |
| merchent.birjanan.com | /www/wwwroot/MerchantsPlatform/dist | 商户端后台 |
| h5.birjanan.com | /www/wwwroot/h5/web | H5 商城 |
| jzadmini.birjanan.com | 反代 → 127.0.0.1:8080 | 后台 API |
| jzfront.birjanan.com | 反代 → 127.0.0.1:8081 | 小程序 API |
| info.birjanan.com | /www/wwwroot/InfoSite | 本知识库 |
| api.birjanan.com | /www/wwwroot/api.birjanan.com | 暂未启用 |
| 图片存储 | /www/wwwroot/crmebimage/ | 上传的图片文件 |
| 数据库 & 缓存 | 端口 / 账号 | 说明 |
|---|---|---|
| MySQL | 3306 · root / Am1269802307 | 生产库 java_mer_dev(193 张表) |
| Redis | 6379 · 密码 Am1269802307 | 缓存 / 会话,绑定了 0.0.0.0 |
| 连接命令 | mysql -h8.130.210.87 -uroot -p java_mer_dev | 服务器本机执行;中文显示请加 --default-character-set=utf8mb4 |
| 第三方密钥 / 备份 | 值 | 位置 |
|---|---|---|
| 微信小程序 AppID | wxb6731905c689fde4 | 小程序后台 / manifest.json |
| 阿里云 DNS AccessKey | LTAI5t9qAicihXWBHLFTYBnu | 宝塔 /www/server/panel/config/dns_mager.conf |
| 数据库备份 | 约 16M | /www/backup/database |
| 文件历史 / nginx / 旧数据 | 21M / 7.9M / 590M | /www/backup/{file_history,nginxBak,oldData} |
所有端的入口与账号。改密码后请联系管理员更新。
| 端 | 地址 | 账号 | 密码 |
|---|---|---|---|
| 平台总后台 | back.birjanan.com | Birjanan | #BirJanan.14x |
| 商户端后台 | merchent.birjanan.com | 18170991486 | 000000 |
| 商户端后台(测试) | merchent.birjanan.com | 13467889900 | 000000 |
| 小程序用户端 | 微信小程序 | 微信授权 | — |
| 员工接单端 | 小程序 → 服务人员登录 | 18999893839 | 000000 |
| 员工接单端 | 小程序 → 服务人员登录 | 17590813665 | 000000 |
| 本知识库 | info.birjanan.com | BIRJANANINFO | (联系管理员) |
下面这些都在实际使用中遇到过,碰到问题先查这里。
wx.login 拿到的 code 无效(appid 与后端配置不匹配)。先清缓存重新编译登录;仍不行则检查后端小程序配置的 appid / secret 是否与项目 manifest.json 里的 appid 一致。unpackage/dist 的编译产物时间,再确认微信开发者工具加载的目录。uxpagediy/getUxServiceData,商城侧 index/get/bottom/navigation),彻底修改需在平台后台改底部导航配置;前端另有兜底归一化逻辑。E:\xiangmu\.cache 双击 start-all.ps1(需 Java8 / MySQL / Redis 已装好),起 8080 / 8081 后再起两个后台(9527 / 9528)。注意启动脚本要带 --server.port 显式端口,避免环境变量干扰。