终端注册与登录
一、功能概述
1. 功能简介
SAAS门店后台系统按「终端」管控访问：每一台用来操作后台的电脑、平板或触屏一体机，第一次打开网页时都要先完成终端注册，之后才能用账套与操作员账号登录，并在登录后绑定一家分店。注册面板给出「注册码注册」「分店绑定注册」「分店授权码」三种方式，各自要填的输入项与前置条件不同；注册完成后进登录界面选账套、输用户名与密码，登录后顶栏出现分店名才算真正可用。
功能路径：浏览器 → https://cdn.mstarsoft.com/APPS/ShopBackend_V2/index.html → 注册机器 → 用户登录 → 绑定分店
2. 核心用途
- 终端准入：通过注册把这台设备登记进系统，未注册设备看不到业务数据；
- 账套选择：同一套后台承载多个账套，登录时先在账套下拉里选中门店所属账套；
- 分店定位：登录成功后绑定分店，八个模块的所有单据、库存、报表都以绑定分店为口径。
3. 整体结构
首次访问依次经过三个界面：
- 注册机器面板：浮在页面上方，含「注册码注册」「分店绑定注册」「分店授权码」三个页签；
- 登录界面：账套下拉 + 用户名 + 密码 + 登录；
- 绑定分店弹窗：选择分店后确认绑定。
二、界面布局说明
注册机器面板
| 区域 | 界面内容 |
|---|---|
| 面板标题 | 注册机器 |
| 页签 | 注册码注册 / 分店绑定注册 / 分店授权码 |
| 终端号 | 面板固定展示本机的终端号，由系统分配、只读展示，操作员不需要抄写或录入 |
| 输入项 | 客户码、注册码、手机号、验证码（按页签提供） |
| 按钮 | 获取验证码、注册机器、返回登录 |
面板顶栏在未注册状态下仍显示八个模块名与「未绑定分店」「版本号（当前为 v1.1101.8）」「点击绑定分店」，并多出一个「?」帮助入口。
登录界面
| 区域 | 界面内容 |
|---|---|
| 账套下拉 | 列出当前可登录的账套，每项带方括号账套编码 |
| 用户名输入框 | 占位提示「用户名」 |
| 密码输入框 | 占位提示「密码」 |
| 登录按钮 | 文案「登录」，提交后校验账套与账号 |
三、业务操作步骤
步骤 1：打开访问地址
浏览器输入 https://cdn.mstarsoft.com/APPS/ShopBackend_V2/index.html，页面地址栏落在 #/app/home。这台设备第一次使用时，页面浮出「注册机器」面板。
步骤 2：选择注册方式并填写
按实施方交付的方式点击对应页签：
- 注册码注册：填「客户码」（占位提示「请输入10位客户码」）与「注册码」（占位提示「开发商提供的唯一授权码」）；需要短信核验时，再填「手机号」（占位提示「软件服务商备案手机号」）并点「获取验证码」，把收到的短信内容填入「验证码」；
- 分店绑定注册：按页签提示填入实施方提供的分店绑定信息后提交；
- 分店授权码：按页签提示填入实施方下发的分店授权码后提交。
三个页签提交入口相同，都点面板底部的「注册机器」。
步骤 3：确认注册结果
注册成功后「注册机器」面板收起，页面进入登录界面。若面板不收起，说明注册项未通过校验，回到对应页签核对后重新提交。
步骤 4：选择账套并登录
在账套下拉中选中门店所属账套，输入门店操作员的用户名与密码，点「登录」。登录成功后顶栏显示版本号，左侧八个模块可点击。
步骤 5：绑定分店
登录后顶栏若显示「未绑定分店」，点「点击绑定分店」打开弹窗，在搜索框按名称或编号定位分店，点击列表行选中，再点「确认绑定」；按钮短暂显示「绑定中...」后弹窗关闭，顶栏改为显示分店名称。
绑定完成即可进入首页工作台开始作业。绑定弹窗各界面元素的说明见 SAAS门店后台系统简介。
四、字段详细说明
1）注册机器面板输入项
| 字段名 | 占位提示 | 含义 |
|---|---|---|
| 客户码 | 请输入10位客户码 | 账套在系统中的客户标识，位数固定为 10 位 |
| 注册码 | 开发商提供的唯一授权码 | 由开发商为终端下发的唯一注册码 |
| 手机号 | 软件服务商备案手机号 | 用于接收短信验证码，必须是服务商处已备案的号码 |
| 验证码 | 验证码 | 点「获取验证码」后短信下发的核验码 |
| 终端号 | — | 面板展示的机器编号，由系统分配，操作员不需手工填写 |
2）登录界面输入项
| 字段名 | 含义 |
|---|---|
| 账套 | 门店所属账套，决定能看到哪一套门店数据 |
| 用户名 | 门店操作员账号 |
| 密码 | 操作员登录密码 |
3）注册方式对照
| 页签 | 前置条件 |
|---|---|
| 注册码注册 | 已拿到客户码与注册码；走短信核验时手机号已在软件服务商处备案 |
| 分店绑定注册 | 目标分店已在总部后台建档，并已生成可绑定的分店信息 |
| 分店授权码 | 已拿到实施方下发的分店授权码 |
出于安全要求，客户码、注册码、分店授权码、手机号等都不写进帮助文档，也不保存在共享电脑里，按实施方交付单当面录入。
五、典型使用场景
场景 1：新门店开业配置后台终端
新门店的收银台电脑第一次打开访问地址即出现「注册机器」面板。操作员按实施方给的分店授权码走「分店授权码」页签注册，注册成功后选账套登录，绑定本店分店，随后在 系统 → 期初建账 录入期初结存并「生效建账」，门店才开始用订货、收货等功能。
场景 2：门店换电脑或重装浏览器
换了设备等于新终端，要重新走一遍注册。在新设备上打开访问地址，用「注册码注册」页签按客户码与注册码登记终端，再登录原账套与账号，绑定同一分店后数据口径不变。
场景 3：一家门店多个岗位分别登录
吧台、内场、裱花岗各有一台设备时，每台设备都要单独完成终端注册，再分别登录对应操作员账号并绑定到同一家分店，各终端看到的业务数据同源。
六、前置条件
- 能访问
https://cdn.mstarsoft.com/APPS/ShopBackend_V2/index.html的浏览器环境； - 门店已开通账套，且已建好分店档案；
- 已拿到实施方交付的注册方式与对应码值（客户码、注册码或分店授权码）；
- 门店操作员的用户名与密码；
- 使用短信核验时，接收号码必须是软件服务商处备案手机号。
七、常见问题
1. 登录成功仍然弹出「注册机器」面板
- 原因：这台设备的终端注册没有完成，页面回到未注册状态；
- 处理：在对应页签重新填写并点「注册机器」；不需要注册时点「返回登录」回到登录界面。
2. 点「获取验证码」没有收到短信
- 原因：填写的号码不是软件服务商处备案手机号，短信通道不会下发；
- 处理：改用备案手机号后重新点「获取验证码」，仍未收到时联系实施方核对该号码的备案状态。
3. 账套下拉里没有门店所属账套
- 原因：登录环节取到的账套列表与门店开通范围不一致；
- 处理：改选其他账套确认能否看到门店数据，仍缺失时联系实施方核对该账套的开通状态。
4. 登录后所有模块点不开，顶栏显示「未绑定分店」
- 原因：终端尚未绑定分店，业务功能在绑定前不可用；
- 处理：点「点击绑定分店」，选中分店后「确认绑定」。
5. 绑定分店弹窗提示「当前租户下暂无分店，请先在总部后台创建分店」
- 原因：该账套下还没有建档的分店；
- 处理：先在总部后台建好分店档案，回到弹窗点「重试」重新加载列表。
6. 页面提示「分店会话尚未就绪，请稍候重试」
- 原因：登录或绑定后的会话还在恢复，业务数据尚未取回；
- 处理：等待几秒刷新页面；持续出现时退出重新登录，再确认分店绑定状态。