Birjanan 家政平台

内部知识库 · 请登录后查看

内部培训 · 知识库

Birjanan 家政平台 · 使用说明

整理了平台四个端的入口和账号，以及用户下单、商户入驻、师傅接单三条主要流程的操作步骤，供培训和日常查阅。

4个端
3条核心流程
21个关键步骤
193张数据表
1

先认识整个系统：四个端的分工

系统一共 4 个端，各管各的事，合起来完成一单家政服务。下面的色块代表操作角色，全文都用它标注。

用户端（业主） 员工端（师傅） 商户端（门店） 平台端（运营方）

平台总后台

运营方用，管全局

网址
back.birjanan.com
账号
Birjanan
密码
#BirJanan.14x

商户端后台（门店）

家政公司 / 门店用，管自己店铺

网址
merchent.birjanan.com
账号
18170991486
密码
000000

小程序用户端（业主）

客户用，浏览、下单、评价

入口
微信搜索 / 扫码打开小程序
登录
微信授权一键登录

小程序员工端（师傅）

服务人员用，接单、上门、提现

入口
小程序 → 我的 → 服务人员登录
账号
18999893839
密码
000000
简单说：用户在小程序下单 → 平台 / 门店派单或师傅抢单 → 师傅上门服务并核销 → 平台抽成、门店与师傅结算。四个端就是这条链路上的四个角色。
2

三条主要流程（点击每一步看详情）

每一步都写清了谁来操作、在哪里点、具体做什么，可以对着系统边看边讲。

登录›选服务 / 发需求› 确认订单›支付› 派单 / 抢单›上门核销›评价结算
入口：微信搜索 / 扫码打开小程序 → 首页
  • 微信授权一键登录，首次可授权获取手机号
  • 底部导航含「商城 / 分类 / 家政」等板块，家政业务从首页或分类进入
路径：家政首页 → 服务分类 service_user/cate → 服务列表 item_list → 详情 item_detail
  • 按分类浏览服务项目（保洁、家电清洗、月嫂、维修等）
  • 进入详情选规格 / 数量，查看价格与说明
  • 可加入购物车 cart，或直接「立即下单」
  • 也可先看「服务人员」列表 service_person_list，指定心仪师傅
路径：家政首页「发布需求」→ service_user/need_add
  • 填写需求：服务类型、期望时间、上门地址、需求描述、预算区间
  • 提交后进入「需求池」，平台与师傅可见
  • 在「我的需求」need_list 里随时查看进度
两种方式的区别：A 是明码标价直接买；B 是「发需求让人报价」，适合非标准化、需上门评估的服务。
路径：需求详情 need_info → 同意报价 → 确认订单 order_confirm → 预约时间 reservation_time
  • 对比师傅报价，选择其一「同意报价」（竞价模式）
  • 确认上门地址 address_list（可新增 / 修改）
  • 选择预约上门时间段
  • 选择优惠券 user_coupon，查看应付金额
  • 提交订单，生成订单号
入口：收银台 → 微信支付
  • 调起微信支付完成付款
  • 支付成功进入 order_pay_sucess，订单状态「待接单」
  • 订单同步进入平台 / 门店待处理列表
平台：后台「家政 → 订单」指派　｜　门店：商户后台「订单」派单　｜　师傅：员工端订单池抢单
  • 平台指派：平台后台家政订单里指定服务人员（service-order/designate）
  • 门店派单：商户端后台「订单」派给本店师傅
  • 师傅抢单：员工端「订单池」自助抢单（rob_order）
  • 确定师傅后，订单状态变为「待服务 / 已接单」
入口：员工端 → 订单详情 service_staff/order_detail
  • 按预约时间上门，到达后「订单签到」开始服务
  • 服务完成提交「订单完成」（核销）
  • 可上传服务凭证 order_subjoin
  • 订单状态变为「已完成 / 待评价」
评价 comment　售后 order_return　结算：平台 / 门店财务
  • 用户打分评价，评价公开展示
  • 有问题可发起售后 / 退款
  • 平台按规则抽成，门店与师傅按分成结算
  • 师傅 / 门店可提现（见流程二、三）
注意：这一步是「钱怎么分」的收口——用户付的钱，平台抽成，剩余按门店与师傅的分成规则结算。
提交入驻申请›平台审核› 开通账户›登录门店后台› 首次配置›正常运营
入口：小程序「门店入驻」company/company_apply
  • 填写公司名称、联系人、联系电话（短信验证码校验）
  • 上传资质：营业执照、法人信息、经营类目
  • 提交后在「入驻记录」apply_list 查询审核进度
入口：平台总后台 → 商户管理 → 入驻申请 merchant/application
  • 平台运营查看申请资料与资质
  • 通过 / 驳回，驳回时填写原因
  • 可对申请加备注，便于内部流转
入口：平台总后台 → 商户管理
  • 审核通过后系统生成商户后台账号（手机号 + 密码）
  • 分配后台菜单与角色权限（只能看自己店铺数据）
  • 设置商户类型 / 经营分类，确定抽成与结算规则
入口：merchent.birjanan.com → 手机号 + 密码登录
  • 进入商户端「工作台 Dashboard」
  • 首次登录建议先改密码（系统设置 → 修改密码）
入口：商户端后台左侧菜单
  • ① 店铺信息：名称、Logo、简介、门店地址、营业时间
  • ② 服务项目：配置服务分类与服务商品（价格、规格、说明）
  • ③ 员工管理：添加服务人员（师傅），为师傅开账号
  • ④ 财务设置：绑定提现账户、设置结算方式
  • ⑤ 页面装修（可选）：门店主页 / 活动页装修
顺序建议：先建服务项目 → 再添师傅 → 再设财务，最后装修。师傅只有被添加后，才能在小程序员工端登录接单。
入口：商户端后台各菜单
  • 接单 / 派单：处理用户订单，指派本店师傅上门
  • 订单与售后：订单跟踪、退款处理
  • 财务：查看收入、结算明细、发起提现
  • 营销：发布优惠券、付费会员等促销活动
  • 员工：师傅排班、接单状态管理
提交申请›审核开通› 员工端登录›设置接单› 抢单 / 派单›上门核销›佣金提现
入口：小程序员工端「师傅申请」service_staff/staff_apply
  • 填写姓名、手机号、技能 / 可提供的服务项目
  • 上传相关证书（月嫂证、电工证等）、所在城市
  • 提交后在「申请记录」staff_apply_list 查看进度
平台：后台「家政 → 服务人员申请」　｜　门店：商户后台「员工管理」
  • 平台审核：审核师傅申请（base-staff-apply/staff_save_apply）
  • 门店添加：商户后台「员工管理」直接新增师傅
  • 通过后生成服务人员账号（登录名 + 初始密码）
  • 把师傅关联到所属门店 / 城市服务范围
两种来源：师傅可自行申请（平台审核），也可由门店直接添加，最终都落在「服务人员」账号里。
入口：小程序 →「我的」→ 服务人员登录 service_staff/login
  • 用登录名 + 密码登录（front/staff/login_staff）
  • 登录后进入员工工作台 service_staff/index
  • 首次登录建议修改密码 edit_psw
入口：员工端 → 我的 / 设置
  • 完善个人资料（头像、简介、资质）
  • 设置可接的服务项目 edit_item
  • 设置接单时段 edit_time
  • 设置接单位置 / 服务范围 edit_place
  • 开启「接单状态」，才开始接单
关键开关：只有打开「接单状态」，师傅才会收到 / 抢到订单；时段与位置决定能接到哪些单。
入口：员工端 → 订单列表 / 订单池 / 需求池
  • 订单池抢单：在订单列表里抢单（rob_order）
  • 接收指派：平台或门店派单给该师傅
  • 需求报价：对用户发布的竞价需求报价 need_list
  • 查看排班日历 calendar，合理安排时间
入口：员工端 → 订单详情
  • 按预约时间上门，到达后「订单签到」
  • 完成服务后提交「订单完成」（核销）
  • 可上传服务凭证 / 附加信息
入口：员工端 → 收入统计 → 提现
  • 查看收入统计与佣金明细
  • 发起提现 / 查看提现记录
  • 提现由平台 / 门店财务审核打款
3

流程脑图（点击节点展开 / 收起）

同样的三张流程图，按层级整理。给同事讲解时一层层点开就行。

  • 用户下单 / 发布需求▾
    • ① 登录▾
      • 微信授权一键登录
      • 绑定手机号
    • ② 发起服务（两种方式）▾
      • A 直接下单：分类 → 服务详情 → 立即下单
      • B 发布需求：填需求 → 进需求池等报价
    • ③ 确认价格并支付▾
      • 需求模式：看报价 → 同意报价
      • 确认地址 → 预约时间 → 优惠券 → 微信支付
    • ④ 派单 / 抢单▾
      • 平台或门店指派师傅
      • 师傅在订单池抢单
    • ⑤ 师傅上门服务▾
      • 按预约时间上门
      • 订单签到 → 服务完成（核销）
    • ⑥ 完成 · 评价 · 结算▾
      • 用户评价 / 售后退款
      • 平台抽成 → 门店 / 师傅结算 → 提现
4

技术架构与部署

技术相关：系统分层、域名、服务器和本地环境。

小程序用户端mer_uniapp
小程序员工端同一 uniapp 内
平台总后台mer_plat_admin
商户端后台mer_mer_admin
↓
crmeb-front · 8081小程序 + 员工端 API（/api/front/）
crmeb-admin · 8080两个后台 API（/api/admin/）
↓
MySQL 3306java_mer_prod（193 张表）
Redis 6379缓存 / 会话
Nginx域名反代 + 静态站点
域名是什么后端 / 目录
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.comH5 商城/www/wwwroot/h5/web
info.birjanan.com本知识库/www/wwwroot/InfoSite

项目四件套（代码仓库）

  • mer_java：后端 SpringBoot 双模块（admin 8080 / front 8081）
  • mer_plat_admin：平台总后台前端（Vue）
  • mer_mer_admin：商户端后台前端（Vue）
  • mer_uniapp：小程序（用户端 + 员工端 + 门店端同体）
  • 小程序分包：service_user(34页) service_staff(21页) company(20页) admin(18页)

服务器（8.130.210.87）

  • SSH 端口 51393，密钥登录
  • 宝塔 nginx，站点配置 /www/server/panel/vhost/nginx/
  • Java：8080（admin）/ 8081（front）
  • MySQL / Redis 仅本机访问（建议关闭公网暴露）
  • 日志：/www/wwwlogs/

小程序发布流程

  • HBuilderX 打开 mer_uniapp → 发行 → 小程序
  • 产物 unpackage/dist/build/mp-weixin
  • 微信开发者工具上传（主包 ≤ 2MB，当前 1.73MB）
  • mp.weixin.qq.com 提交审核 → 发布
  • 接口域名 jzfront.birjanan.com 需在合法域名列表

本地开发环境

  • Java8 + Node16 + MySQL5.7 + Redis（E:\xiangmu）
  • 一键启动 start-all.ps1 / 停止 stop-all.ps1
  • 本地后台 9527（商户）/ 9528（平台）
  • 小程序连本地：改 config/app.js 域名为 http://127.0.0.1:8081
5

账号档案

所有端的入口与账号。改密码后请联系管理员更新。

端地址账号密码
平台总后台back.birjanan.comBirjanan#BirJanan.14x
商户端后台merchent.birjanan.com18170991486000000
商户端后台（测试）merchent.birjanan.com13467889900000000
小程序用户端微信小程序微信授权—
员工接单端小程序 → 服务人员登录18999893839000000
员工接单端小程序 → 服务人员登录17590813665000000
本知识库info.birjanan.comBIRJANANINFO（联系管理员）
密码规律：后台账号为 DES 加密（密钥 = 账号名）；服务人员（师傅）为 MD5。两个后台的分辨技巧：有「商户管理」菜单的是平台总后台，只有自家店铺数据的是商户端。
6

常见问题

下面这些都在实际使用中遇到过，碰到问题先查这里。

一般是开发者工具里 wx.login 拿到的 code 无效（appid 与后端配置不匹配）。先清缓存重新编译登录；仍不行则检查后端小程序配置的 appid / secret 是否与项目 manifest.json 里的 appid 一致。
协议内容由后台「协议管理」下发，前端不写死。去平台后台 → 协议管理，把对应协议内容填上保存即可，无需重新发版。
先确认改的是 HBuilderX 当前打开并编译的那份工程（本机有多份副本），看 unpackage/dist 的编译产物时间，再确认微信开发者工具加载的目录。
底部导航由后端下发（家政侧 uxpagediy/getUxServiceData，商城侧 index/get/bottom/navigation），彻底修改需在平台后台改底部导航配置；前端另有兜底归一化逻辑。
没有。师傅统一在小程序「员工端」里完成接单、核销、提现；账号由平台审核或门店「员工管理」创建。
在 E:\xiangmu\.cache 双击 start-all.ps1（需 Java8 / MySQL / Redis 已装好），起 8080 / 8081 后再起两个后台（9527 / 9528）。注意启动脚本要带 --server.port 显式端口，避免环境变量干扰。
Birjanan 家政平台 · 内部知识库　|　info.birjanan.com　|　仅供内部使用，请勿外传