Skip to content

门店端自动入驻与首登可用性

功能目标

门店提交入驻资料并完成手机号验证后,系统自动创建公司、门店、门店资料、门店钱包、默认支付方式、软件版本试用关系和公司负责人账号。正常情况下无需管理员手工建号;自动初始化失败时保留申请记录并转人工补偿。

主流程

  1. 门店端填写公司、营业执照(如有)、负责人手机号、地址和协议,完成短信或微信手机号校验。
  2. 系统先校验手机号是否已有有效申请、账号或门店关联。
  3. 自动审核在一个数据库事务内创建公司、门店、门店资料、钱包、支付方式、版本关系和公司负责人权限。
  4. 所有关键实体校验通过后,申请状态才更新为“已通过”;任一步失败会回滚本次初始化,申请仍保留待处理状态。
  5. 重复触发同一申请时,已完成的自动入驻返回幂等成功,不重复创建公司、门店、账号或支付方式。

首次登录可用范围

能力自动初始化结果
公司负责人登录自动创建负责人账号,负责人角色拥有公司级管理权限
门店资料自动创建并绑定唯一门店
门店钱包自动创建 ACTIVE 钱包账户,余额、扣费和流水读取可用
余额/现金支付默认预置并启用
微信/支付宝/银联预置但默认关闭;需要配置对应商户渠道后再启用,避免空配置下误支付
产品和版本使用平台产品库,创建有效版本试用关系

异常处理

  • 自动审核失败不会把申请伪装成“已开号”,门店端会提示“申请已提交,审核异常将由工作人员处理”。
  • 管理员处理前应先检查公司、门店、负责人、权限、钱包、支付方式和版本关系是否齐全,再执行补偿;不要重复手工建号。
  • 数据库约束迁移执行前必须确认 pay_type(company_uuid, pay_type_code)store(store_uuid) 没有重复值。历史孤儿数据不在本次自动清理范围内,需单独评估。

上线检查

  • 提交一次新入驻,确认申请状态、登录、门店首页、钱包读取和余额/现金支付配置页面均可打开。
  • 对同一申请重复提交/重试,确认只保留一家公司、一家门店、一名负责人和五种默认支付方式。
  • 使用普通门店角色验证不能获得公司负责人通配权限。
  • 执行只读完整性检查,重点关注有效门店缺负责人、钱包、支付方式或版本关系的记录。

用于金刚项目内部协作、运营培训和客户说明。