设备注册 短信跟邮箱验证

This commit is contained in:
yuhaiming
2026-09-23 16:28:24 +08:00
parent bc1074d194
commit 827b48e954
25 changed files with 645 additions and 67 deletions

View File

@@ -0,0 +1,53 @@
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="color-scheme" content="light">
<title>JUMHABI 隐私政策</title>
<style>
:root{--ink:#172033;--muted:#647089;--line:#e6eaf0;--brand:#2563eb;--soft:#eff6ff;--warn:#fff7ed;--danger:#fff1f2;--bg:#f6f8fb;--white:#fff;--anchor-gap:16px}
*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--bg);color:var(--ink);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",Arial,sans-serif;line-height:1.8}
.hero{background:linear-gradient(135deg,#14213d,#2563eb);color:#fff;padding:56px 20px 48px}.hero-inner{max-width:1080px;margin:auto}.eyebrow{font-size:13px;letter-spacing:.12em;opacity:.8}.hero h1{font-size:clamp(30px,5vw,48px);margin:12px 0 8px;letter-spacing:.02em}.hero p{margin:0;max-width:720px;color:#dbeafe;font-size:16px}.meta{display:flex;gap:12px;flex-wrap:wrap;margin-top:24px}.pill{padding:5px 12px;border:1px solid rgba(255,255,255,.35);border-radius:999px;font-size:13px}
.layout{max-width:1080px;margin:28px auto 64px;padding:0 20px;display:grid;grid-template-columns:230px 1fr;gap:28px}.toc{position:sticky;top:18px;align-self:start;background:var(--white);border:1px solid var(--line);padding:18px;border-radius:10px;box-shadow:0 5px 18px rgba(24,39,75,.05)}.toc strong{font-size:14px}.toc a{display:block;color:var(--muted);text-decoration:none;font-size:13px;padding:5px 0}.toc a:hover,.toc a:focus-visible{color:var(--brand)}main{min-width:0}.notice{background:var(--warn);border:1px solid #fed7aa;border-left:4px solid #f97316;padding:16px 18px;border-radius:8px;margin-bottom:20px}.notice strong{color:#9a3412}.card{background:var(--white);border:1px solid var(--line);border-radius:10px;padding:26px 28px;margin:16px 0;box-shadow:0 5px 18px rgba(24,39,75,.04)}h2{font-size:23px;margin:0 0 14px;padding-top:4px}h3{font-size:17px;margin:22px 0 8px}p{margin:8px 0}ul,ol{padding-left:22px}li{margin:5px 0}.tag{display:inline-block;background:var(--soft);color:#1d4ed8;padding:1px 8px;border-radius:5px;font-size:12px}.unconfirmed{color:#9a3412;background:#fff7ed;border:1px dashed #fdba74;border-radius:4px;padding:1px 5px;white-space:normal;font-size:.92em}table{width:100%;border-collapse:collapse;margin:12px 0;font-size:13px;display:block;overflow-x:auto;overscroll-behavior-inline:contain;-webkit-overflow-scrolling:touch;white-space:normal}th,td{border:1px solid var(--line);padding:10px 11px;vertical-align:top;min-width:125px}th{background:#f8fafc;text-align:left;color:#334155}.risk-high{color:#b91c1c;font-weight:700}.risk-mid{color:#c2410c;font-weight:700}.risk-low{color:#166534;font-weight:700}.footer{text-align:center;color:var(--muted);font-size:13px;margin:35px 0}.back{color:var(--brand);text-decoration:none;font-size:13px}section[id]{scroll-margin-top:var(--anchor-gap)}@media(max-width:820px){.hero{padding:36px 18px 30px}.hero h1{font-size:32px}.hero p{font-size:15px}.meta{gap:8px;margin-top:18px}.pill{font-size:12px}.layout{display:block;margin:14px auto 40px;padding:0 12px}.toc{position:sticky;top:0;z-index:5;margin:0 -12px 14px;padding:8px 12px 9px;border-width:0 0 1px;border-radius:0;box-shadow:0 3px 12px rgba(24,39,75,.08);overflow:hidden}.toc strong{display:block;font-size:12px;margin:0 0 5px}.toc a{display:inline-flex;align-items:center;white-space:nowrap;min-height:34px;margin:0 6px 0 0;padding:5px 10px;border:1px solid var(--line);border-radius:6px;background:#fff;font-size:12px}.toc nav{display:flex;overflow-x:auto;overscroll-behavior-inline:contain;-webkit-overflow-scrolling:touch;scrollbar-width:thin;padding-bottom:2px}.toc a:focus-visible{outline:2px solid var(--brand);outline-offset:1px}.notice{padding:13px 14px;margin-bottom:12px}.card{padding:18px 15px;margin:12px 0;border-radius:8px;box-shadow:0 2px 10px rgba(24,39,75,.035)}h2{font-size:20px;margin-bottom:10px}h3{font-size:16px;margin:18px 0 6px}p,li{font-size:14px}ul,ol{padding-left:20px}table{font-size:12px}th,td{padding:8px 9px;min-width:116px}.footer{margin:25px 0;font-size:12px}section[id]{scroll-margin-top:76px}}
</style>
</head>
<body id="top">
<header class="hero"><div class="hero-inner"><div class="eyebrow">JUMHABI · PRIVACY CENTER</div><h1>JUMHABI 隐私政策</h1><p>我们重视您的个人信息和隐私。本政策以清晰、易懂的方式说明 JUMHABI 可能如何处理个人信息,以及您可以如何行使相关权利。</p><div class="meta"><span class="pill">版本:V1.0</span><span class="pill">生效日期:2026年10月1日</span><span class="pill">适用平台:Android</span></div></div></header>
<div class="layout">
<aside class="toc"><strong>目录</strong><nav><a href="#pending">待确认事项</a><a href="#scope">一、引言</a><a href="#collect">二、收集与使用</a><a href="#device">三、设备信息</a><a href="#video">四、实时视频</a><a href="#location">五、位置与地图</a><a href="#account">六、账号安全</a><a href="#storage">七、存储与安全</a><a href="#sharing">八、共享与 SDK</a><a href="#rights">九、您的权利</a><a href="#delete">十、账号注销</a><a href="#minor">十一、未成年人</a><a href="#update">十二、更新与联系</a><a href="#checklist">开发者清单</a><a href="#risks">上线风险</a></nav></aside>
<main>
<section id="pending" class="notice"><strong>《隐私政策说明》</strong><p>本政策已根据当前提供的问题解答、AndroidManifest.xml 和 Gradle 依赖进行修订。第三方服务的具体数据字段、服务协议及部分后端安全配置仍应在上线前由研发和服务商资料最终核验。</p><ol><li>核验地图、短信、视频及海外云服务的准确服务商名称、处理数据字段和跨境处理安排。</li><li>核验服务端数据永久保存的必要性,以及备份、删除和访问控制措施。</li><li>核验录音、安装包请求、通知、图片/存储权限是否由应用实际调用及其对应功能。</li></ol></section>
<section id="scope" class="card"><h2>一、引言</h2><p>本隐私政策适用于 JUMHABI Android 应用(以下简称“本 App”)。本政策中的“我们”指深圳市聚心时代科技有限公司(个人信息处理者);“您”指本 App 用户。</p><p>在使用具体功能前,我们会按照必要、透明、最小化原则告知处理目的、方式和范围,并在依法需要时取得您的同意。您可以选择不提供非必要信息,但可能无法使用相应功能。</p></section>
<section id="collect" class="card"><h2>二、我们如何收集和使用您的个人信息</h2><h3>1. 注册、登录与身份验证</h3><p>本 App 支持手机号和邮箱注册/登录。为创建和管理账号、验证登录及保障账号安全,我们处理您的手机号、邮箱、验证码、账号 ID 和登录 token。短信验证码由阿里云短信服务提供;邮箱验证码服务商以实际配置为准。登录设备信息、IP 地址、登录时间和操作日志是否由服务端记录及其保存期限,以服务端实际配置为准。</p><h3>2. 设备绑定与管理</h3><p>您可扫描设备二维码绑定设备。扫码内容主要包括设备编码、生产批次等设备信息,用于识别设备并建立账号与设备的绑定关系。扫码使用手机摄像头;您也可以通过相册选择二维码图片(如该入口可用)。</p><h3>3. 远程控制与设备数据展示</h3><p>您发起控制操作时,服务端会根据账号和设备绑定关系处理相应请求。设备产生的设备状态、运行数据及设备位置等信息由设备提供给服务端,本 App 从服务端获取并向您展示。我们不通过本 App 采集手机硬件信息并上传至服务器。</p><h3>4. 个人中心</h3><p>本 App 保存和展示的账号资料包括手机号、邮箱、昵称、头像、用户 ID 和注册时间。您可以在 App 内修改绑定手机号、邮箱及个人密码;按目前提供的信息,修改时不要求额外身份认证。</p></section>
<section id="device" class="card"><h2>三、我们如何处理设备信息</h2><p>为展示和管理您绑定的设备,本 App 从服务端读取由硬件设备提供的设备编码、生产批次、设备状态、运行数据及设备位置信息等(具体展示字段以设备和服务端实际提供为准)。这些信息可能与您的账号和绑定关系关联,用于设备展示、状态判断、远程控制和服务支持。本 App 不采集手机硬件信息上传至服务器。设备信息在服务端的保存期限见第七条。</p></section>
<section id="video" class="card"><h2>四、实时视频功能及相关信息处理</h2><p>本 App 可查看已绑定设备的实时预览画面,视频由设备端产生。本 App 仅从服务端拉取视频流进行播放,不通过手机推送视频流;按目前提供的信息,本 App 不在本地录制或保存视频。Android 工程引入了 GSYVideoPlayer 播放器依赖。设备视频流在设备、服务端和 App 之间的完整传输路径、服务端是否中转或留存及其供应商,应以实际部署为准。</p><p>Manifest 声明了手机摄像头和麦克风权限。摄像头用于扫描设备二维码;目前提供的信息未说明 App 使用手机麦克风采集音频。拒绝摄像头权限将影响扫码绑定。我们会在相关功能调用权限前说明用途。</p></section>
<section id="location" class="card"><h2>五、位置与地图服务</h2><p>当您打开地图查看设备所在地址时,本 App 会在地图上展示设备位置,并展示您手机当前的位置。为提供该功能,App 声明并可能使用 Android 精确定位权限(ACCESS_FINE_LOCATION);您可以通过系统权限设置拒绝或撤回定位授权,届时手机当前位置功能将不可用,但不影响无需定位的其他功能。设备位置由硬件设备提供给服务端,不等同于手机定位。</p><p>当前使用高德地图海外定位服务。使用地图及定位功能时,手机当前位置信息和/或用于地址展示的设备经纬度可能按功能需要提供给该服务进行地图展示或定位处理。具体传输字段、服务主体名称、存储期限和跨境处理安排应以实际接入配置及服务条款核验。</p></section>
<section id="account" class="card"><h2>六、账号注册、登录与安全</h2><p>账号密码用于账号安全。App 与服务端之间使用 HTTPS 传输。我们不会在本政策中披露密钥、服务器配置等敏感安全细节;服务端访问控制、密码保存方式及 token 的有效期和失效机制按实际安全配置执行。</p><p>您可以在 App 内修改个人密码、绑定手机号和邮箱,也可以退出登录。退出登录时,本地缓存会清理,登录 token 等本地账号信息会按应用实际退出流程清除。</p></section>
<section id="storage" class="card"><h2>七、个人信息的存储与保护</h2><p>本地保存必要的用户基础信息,包括昵称、登录账号、登录方式和 token 等;退出登录时清理缓存。按目前提供的信息,服务端数据存储在阿里云海外云服务器并永久保存,直至您注销账号或依法需要删除。永久保存安排及其必要性应持续评估,并落实可执行的数据删除机制。</p><p>App 与服务端之间使用 HTTPS 传输。我们将采取与风险相适应的访问控制、最小权限和安全保护措施。备份策略、服务端访问权限及具体加密措施以实际架构和运维配置为准。发现个人信息泄露等安全事件时,我们将依法采取补救并按规定告知。</p></section>
<section id="sharing" class="card"><h2>八、共享、委托处理与第三方服务</h2><p>我们不会在没有必要性或法律依据的情况下出售您的个人信息。为提供地图、短信验证、视频播放和云服务器等服务,相关信息可能由对应服务商根据服务目的处理;我们会依法通过协议等方式约束受托方的处理目的和安全义务。</p><h3>第三方 SDK/服务清单</h3><table><thead><tr><th>SDK/服务</th><th>服务商/组件</th><th>用途</th><th>可能涉及的数据类型</th><th>处理方式</th></tr></thead><tbody><tr><td>高德地图海外定位服务</td><td>高德地图服务(具体海外服务主体待接入资料核验)</td><td>展示地图、手机当前位置及设备地址</td><td>手机当前位置、设备经纬度(按具体功能需要)</td><td>由 App 按功能调用地图/定位服务;具体字段和跨境路径以接入配置为准</td></tr><tr><td>阿里云短信服务</td><td>阿里云</td><td>发送手机号验证码</td><td>手机号、验证码发送请求及必要服务日志</td><td>通过短信服务发送验证码</td></tr><tr><td>阿里云海外云服务器</td><td>阿里云(具体地域待配置核验)</td><td>提供服务端及存储</td><td>账号资料、设备绑定信息、设备数据及服务运行所需信息</td><td>服务端存储和处理</td></tr><tr><td>扫码组件</td><td>MNMLKitScanner、Google ML Kit Barcode Scanning、AndroidX CameraX</td><td>扫描设备二维码</td><td>摄像头实时画面;二维码中的设备编码、生产批次等信息</td><td>扫码识别;是否有组件向其供应商发送数据需以 SDK 实际行为和配置核验</td></tr><tr><td>视频播放器</td><td>GSYVideoPlayer</td><td>播放服务端下发的设备视频流</td><td>视频流地址、播放请求及必要网络信息</td><td>App 从服务端拉流播放;App 不推流、不在本地录制保存视频</td></tr></tbody></table><p>Gradle 文件还包含 Retrofit、OkHttp、Gson、Luban、AndroidX 和界面组件等通用依赖。仅凭依赖声明不能确认这些组件是否会收集或向第三方传输个人信息;我们会根据实际功能调用和 SDK 行为核验并在需要时补充披露。</p></section>
<section id="rights" class="card"><h2>九、您的个人信息权利</h2><p>在符合法律规定的前提下,您享有知情、决定、查阅、复制、更正、删除、撤回同意、注销账号及要求解释说明个人信息处理规则等权利。您可以在 App 内修改手机号、邮箱和个人密码;其他个人信息请求可通过 App 设置中的联系方式或本政策列明的客服邮箱提交。我们可能为核实请求而进行必要身份确认。对于无法满足的请求,我们会说明理由。</p></section>
<section id="delete" class="card"><h2>十、用户账号注销</h2><p>您可以在 App 个人中心发起账号注销。申请前需先取消所有已绑定设备;在您确认注销后,服务端将在数据库删除该用户信息。注销后账号及其关联服务将无法继续使用。备份数据的清除时间、依法必须保留或争议处理所需信息的范围和期限,以实际数据删除及备份机制为准;如需保留,我们会依法限制其用途并在保存期限届满后删除或匿名化。</p></section>
<section id="minor" class="card"><h2>十一、未成年人保护</h2><p>本 App 可以面向未成年人。未成年人使用本 App 或提供个人信息,应在监护人指导下阅读本政策,并在法律要求时取得监护人同意。监护人如对未成年人个人信息处理有疑问或希望行使相关权利,可通过下方联系方式联系我们,我们将依法处理。</p></section>
<section id="update" class="card"><h2>十二、隐私政策更新与联系我们</h2><p>我们可能根据业务、法律法规或功能变化更新本政策。重大变更将通过 App 弹窗、页面提示或其他适当方式通知,并在页面标注最新版本和生效日期。您可在 App 的“隐私政策”入口查看当前版本。</p><p><strong>个人信息处理者:</strong>深圳市聚心时代科技有限公司<br><strong>联系邮箱:</strong><a href="mailto:huzuming2@gmail.com">huzuming2@gmail.com</a><br><strong>公司地址:</strong>深圳市宝安区沙井街道马安山社区马安山鞍胜路2号C栋203<br><strong>隐私负责人:</strong>深圳市聚心时代科技有限公司(联系邮箱同上)</p><p><strong>生效日期:</strong>2026年10月1日</p></section>
<section id="checklist" class="card"><h2>上线前核验清单</h2><table><thead><tr><th>检查项目</th><th>当前已知情况</th><th>仍需核验</th><th>核验内容</th></tr></thead><tbody>
<tr><td>Android 权限</td><td>Manifest 声明网络、请求安装包、通知、摄像头、录音、精确定位、读取图片/旧版外部存储权限</td><td>是</td><td>确认运行时申请时机、拒绝影响,以及录音、安装包请求、通知和图片/存储权限的实际功能</td></tr><tr><td>第三方 SDK</td><td>Gradle 包含 MNMLKitScanner、Google ML Kit Barcode Scanning、CameraX、GSYVideoPlayer、Retrofit/OkHttp 等</td><td>是</td><td>核验 SDK 实际数据收集行为、供应商、隐私链接及是否发生对外传输</td></tr><tr><td>地图与定位</td><td>高德地图海外定位服务;地图展示设备地址及手机当前位置</td><td>是</td><td>补充准确服务主体、位置字段流向、海外处理/跨境安排及服务商保存期限</td></tr><tr><td>视频</td><td>从服务端拉流播放;不推流、不本地录制保存;依赖 GSYVideoPlayer</td><td>是</td><td>确认流媒体服务商、服务器是否中转/留存及视频流保存期限</td></tr><tr><td>服务器与删除</td><td>阿里云海外云服务器;目前说明为永久保存;注销后服务端数据库删除用户信息</td><td>是</td><td>确认云服务器具体地域、永久保存必要性、备份删除时限和法定保留范围</td></tr><tr><td>账号与本地数据</td><td>本地保存昵称、登录账号、登录方式、token;退出登录清缓存</td><td>是</td><td>核验 token 失效方式、缓存范围、日志/Crash 字段及保存期限</td></tr><tr><td>未成年人</td><td>App 可以面向未成年人</td><td>是</td><td>确认监护人同意及未成年人个人信息保护流程如何在产品中落实</td></tr><tr><td>主体与联系方式</td><td>深圳市聚心时代科技有限公司;邮箱和地址已提供,不留电话</td><td>否</td><td>确认邮箱可正常接收和处理权利请求</td></tr></tbody></table></section>
<section id="risks" class="card"><h2>上线前隐私合规风险清单</h2><table><thead><tr><th>级别</th><th>风险与原因</th><th>建议处理</th></tr></thead><tbody><tr><td class="risk-high">高风险</td><td>阿里云海外服务器永久保存数据,且地图使用海外定位服务,涉及境外存储/处理及可能的数据跨境合规要求。</td><td>核实具体国家或地区、数据类别和流向,评估并依法落实个人信息出境告知、单独同意及适用的出境合规机制。</td></tr><tr><td class="risk-high">高风险</td><td>Manifest 声明录音、请求安装包等权限,但现有说明未指出对应业务用途。</td><td>确认应用是否实际调用;不必要权限应从 Manifest 移除,必要权限应在申请前清楚说明目的。</td></tr><tr><td class="risk-mid">中风险</td><td>设备位置、手机当前位置、视频流及服务商的实际字段和流向尚未由代码/服务商资料验证。</td><td>核验 SDK 和网络数据流,补齐服务主体、处理字段、保存期限及必要的单独同意。</td></tr><tr><td class="risk-mid">中风险</td><td>服务端称永久保存,注销后数据库删除,但备份和法定保留规则尚未说明。</td><td>评估保存期限的必要性,明确注销和备份删除时限,落实删除/匿名化及受限保留机制。</td></tr><tr><td class="risk-mid">中风险</td><td>面向未成年人,但当前未提供年龄识别和监护人同意流程。</td><td>上线前落实未成年人个人信息保护及监护人同意机制。</td></tr></tbody></table></section>
<p><a class="back" href="#top">返回顶部 ↑</a></p>
</main>
</div><footer class="footer">JUMHABI 隐私政策 · 版本 V1.0</footer>
</body></html>

View File

@@ -0,0 +1,53 @@
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="color-scheme" content="light">
<title>JUMHABI 用户协议</title>
<style>
:root{--ink:#172033;--muted:#647089;--line:#e6eaf0;--brand:#2563eb;--soft:#eff6ff;--warn:#fff7ed;--bg:#f6f8fb;--white:#fff;--anchor-gap:16px}
*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--bg);color:var(--ink);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",Arial,sans-serif;line-height:1.8}
.hero{background:linear-gradient(135deg,#14213d,#2563eb);color:#fff;padding:56px 20px 48px}.hero-inner{max-width:1080px;margin:auto}.eyebrow{font-size:13px;letter-spacing:.12em;opacity:.8}.hero h1{font-size:clamp(30px,5vw,48px);margin:12px 0 8px;letter-spacing:.02em}.hero p{margin:0;max-width:720px;color:#dbeafe;font-size:16px}.meta{display:flex;gap:12px;flex-wrap:wrap;margin-top:24px}.pill{padding:5px 12px;border:1px solid rgba(255,255,255,.35);border-radius:999px;font-size:13px}
.layout{max-width:1080px;margin:28px auto 64px;padding:0 20px;display:grid;grid-template-columns:230px 1fr;gap:28px}.toc{position:sticky;top:18px;align-self:start;background:var(--white);border:1px solid var(--line);padding:18px;border-radius:10px;box-shadow:0 5px 18px rgba(24,39,75,.05)}.toc strong{font-size:14px}.toc a{display:block;color:var(--muted);text-decoration:none;font-size:13px;padding:5px 0}.toc a:hover,.toc a:focus-visible{color:var(--brand)}main{min-width:0}.notice{background:var(--warn);border:1px solid #fed7aa;border-left:4px solid #f97316;padding:16px 18px;border-radius:8px;margin-bottom:20px}.notice strong{color:#9a3412}.card{background:var(--white);border:1px solid var(--line);border-radius:10px;padding:26px 28px;margin:16px 0;box-shadow:0 5px 18px rgba(24,39,75,.04)}h2{font-size:23px;margin:0 0 14px;padding-top:4px}h3{font-size:17px;margin:22px 0 8px}p{margin:8px 0}ul,ol{padding-left:22px}li{margin:5px 0}.footer{text-align:center;color:var(--muted);font-size:13px;margin:35px 0}.back{color:var(--brand);text-decoration:none;font-size:13px}section[id]{scroll-margin-top:var(--anchor-gap)}@media(max-width:820px){.hero{padding:36px 18px 30px}.hero h1{font-size:32px}.hero p{font-size:15px}.meta{gap:8px;margin-top:18px}.pill{font-size:12px}.layout{display:block;margin:14px auto 40px;padding:0 12px}.toc{position:sticky;top:0;z-index:5;margin:0 -12px 14px;padding:8px 12px 9px;border-width:0 0 1px;border-radius:0;box-shadow:0 3px 12px rgba(24,39,75,.08);overflow:hidden}.toc strong{display:block;font-size:12px;margin:0 0 5px}.toc nav{display:flex;overflow-x:auto;overscroll-behavior-inline:contain;-webkit-overflow-scrolling:touch;scrollbar-width:thin;padding-bottom:2px}.toc a{display:inline-flex;align-items:center;white-space:nowrap;min-height:34px;margin:0 6px 0 0;padding:5px 10px;border:1px solid var(--line);border-radius:6px;background:#fff;font-size:12px}.toc a:focus-visible{outline:2px solid var(--brand);outline-offset:1px}.card{padding:18px 15px;margin:12px 0;border-radius:8px;box-shadow:0 2px 10px rgba(24,39,75,.035)}h2{font-size:20px;margin-bottom:10px}h3{font-size:16px;margin:18px 0 6px}p,li{font-size:14px}ul,ol{padding-left:20px}.notice{padding:13px 14px;margin-bottom:12px}.footer{margin:25px 0;font-size:12px}section[id]{scroll-margin-top:76px}}
</style>
</head>
<body id="top">
<header class="hero"><div class="hero-inner"><div class="eyebrow">JUMHABI · USER AGREEMENT</div><h1>JUMHABI 用户协议</h1><p>本协议说明您使用 JUMHABI Android 应用及相关设备服务时的权利、义务和责任。</p><div class="meta"><span class="pill">版本:V1.0</span><span class="pill">生效日期:2026年10月1日</span><span class="pill">适用平台:Android</span></div></div></header>
<div class="layout">
<aside class="toc"><strong>目录</strong><nav><a href="#notice">协议说明</a><a href="#terms">一、接受与适用</a><a href="#account">二、账号注册与使用</a><a href="#device">三、设备绑定与控制</a><a href="#content">四、内容与服务使用</a><a href="#permissions">五、权限与第三方服务</a><a href="#conduct">六、用户行为规范</a><a href="#security">七、服务安全与中断</a><a href="#ip">八、知识产权</a><a href="#liability">九、责任限制</a><a href="#minor">十、未成年人</a><a href="#termination">十一、协议终止</a><a href="#changes">十二、协议更新</a><a href="#contact">十三、联系我们</a></nav></aside>
<main>
<section id="notice" class="notice"><strong>请在使用前阅读</strong><p>请您在注册、登录或使用 JUMHABI 前认真阅读本协议及《JUMHABI 隐私政策》。当您点击同意、注册、登录、绑定设备或实际使用本 App 的服务,即表示您已阅读、理解并同意接受本协议。若您不同意本协议,请停止注册或使用相关服务。</p></section>
<section id="terms" class="card"><h2>一、协议接受与适用</h2><p>本协议由深圳市聚心时代科技有限公司(以下简称“我们”)与 JUMHABI App 用户(以下简称“您”)订立,适用于您通过 Android App 使用账号、设备管理、远程控制、实时视频、地图及其他相关功能。</p><p>本协议与《JUMHABI 隐私政策》共同构成您使用本服务的规则。隐私政策说明我们如何处理个人信息;如两者对个人信息处理事项有不同表述,以隐私政策为准。</p><p>您应当具备与使用本服务相适应的民事行为能力。若您未达到所在地法律规定的相应年龄,应在监护人指导和同意下使用本服务。</p></section>
<section id="account" class="card"><h2>二、账号注册与使用</h2><h3>1. 注册信息</h3><p>本 App 支持使用手机号或邮箱注册、登录。您应提供真实、准确、完整且有效的信息,并及时更新。账号资料包括手机号、邮箱、昵称、头像、用户 ID 和注册时间等,具体以 App 实际功能为准。</p><h3>2. 账号安全</h3><p>您应妥善保管账号、密码、验证码及登录 token,不得将账号出借、出租、出售或以其他方式交由他人使用。因您保管不善、主动披露或使用不当导致的损失,由您自行承担;发现异常登录或安全问题时,请立即通过 App 设置中的联系方式联系我们。</p><h3>3. 账号操作</h3><p>您可以在 App 内修改绑定手机号、邮箱和个人密码,也可以退出登录。您应对使用账号进行的操作承担相应责任。账号注销规则见本协议第十一条及隐私政策相关说明。</p></section>
<section id="device" class="card"><h2>三、设备绑定与控制</h2><h3>1. 设备绑定</h3><p>您可以通过扫描设备二维码绑定硬件设备。二维码主要包含设备编码、生产批次等信息。您只能绑定自己拥有、管理或已获得合法授权使用的设备,不得通过技术手段绕过权限、绑定他人设备或获取未经授权的设备数据。</p><h3>2. 设备数据</h3><p>设备状态、运行数据、设备位置和实时视频等内容由硬件设备或服务端提供。设备数据可能受到设备供电、网络连接、服务端状态、地理环境和其他不可控因素影响,我们不保证设备数据始终实时、完整或无误。</p><h3>3. 远程控制</h3><p>您发起远程控制前,应确认目标设备、控制内容及操作后果。对于可能影响人身、财产、动物、设施或公共安全的设备,请在现场采取必要的安全措施,不应仅依赖 App 的远程控制结果。因网络延迟、设备故障、错误操作或未经授权使用造成的损失,按法律规定及实际责任承担。</p></section>
<section id="content" class="card"><h2>四、内容与服务使用</h2><p>本 App 可能提供设备管理、实时视频、地图展示、账号管理和相关技术服务。我们会根据产品运营、维护和安全需要对功能进行调整、暂停或升级,并尽量通过 App 页面或其他适当方式通知。</p><p>实时视频由设备端产生,本 App 仅从服务端拉取并播放视频流,不提供手机端推流功能;按目前功能说明,本 App 不在本地录制或保存视频。您应确保观看和使用设备视频符合设备所在地法律及他人隐私、肖像和财产权利。</p><p>地图及定位功能用于展示设备地址和手机当前位置。地图、定位结果可能因服务商、网络或定位精度而存在误差,不应作为安全、导航、应急救援或专业决策的唯一依据。</p></section>
<section id="permissions" class="card"><h2>五、系统权限与第三方服务</h2><p>为实现扫码、地图定位、图片选择、通知或其他功能,App 可能申请 Android 摄像头、精确定位、麦克风、通知、图片/存储等系统权限。您可以在系统设置中管理权限;拒绝非必要权限通常只会影响对应功能,但拒绝必要权限可能导致相关功能无法使用。</p><p>本 App 可能使用地图、短信、云服务器、扫码识别、视频播放及网络通信等第三方服务。第三方服务按照其自身协议和隐私规则提供服务;相关处理方式和信息范围请参阅《JUMHABI 隐私政策》中的第三方服务清单。</p></section>
<section id="conduct" class="card"><h2>六、用户行为规范</h2><p>您不得利用本服务从事违反法律法规、侵害他人权益或破坏服务安全的行为,包括但不限于:</p><ul><li>未经授权访问、控制、绑定或监视他人设备、账号或视频内容;</li><li>上传、传播违法、有害、欺诈、侵权、骚扰或侵犯他人隐私的内容;</li><li>反向工程、反编译、破解、抓取、干扰或绕过 App、服务端或设备的安全机制;</li><li>利用本服务发送恶意程序、垃圾请求,或实施可能影响网络、设备和其他用户的行为;</li><li>将本服务用于法律禁止的用途或用于需要专业许可但未取得许可的活动。</li></ul><p>如您违反本条,我们可以根据风险采取提醒、限制功能、暂停服务、解绑设备、注销账号或依法向有关部门报告等措施。</p></section>
<section id="security" class="card"><h2>七、服务安全与中断</h2><p>我们会采取合理的技术和管理措施维护服务安全,并通过 HTTPS 等方式保护 App 与服务端之间的传输。但互联网、移动网络、设备系统和第三方服务均可能出现故障、攻击或不可预见的中断,我们不承诺服务始终连续、无延迟、无错误或完全安全。</p><p>因系统维护、升级、网络故障、设备故障、供应商服务变化、法律要求、不可抗力或其他合理原因导致服务暂时不可用的,我们会在可行范围内进行通知和恢复。</p></section>
<section id="ip" class="card"><h2>八、知识产权</h2><p>JUMHABI App 的软件、界面、文字、图形、标识、页面设计和相关技术成果的知识产权归我们或相关权利人所有。除法律允许或经权利人书面许可外,您不得复制、修改、传播、出租、出售、反向工程或用于本协议约定之外的用途。</p><p>您在使用本服务过程中产生或上传的内容,仍由您或相应权利人享有权利。您应确保自己拥有必要授权,并授予我们为提供、维护、改进和保障本服务所必需的使用权限;具体个人信息处理以隐私政策为准。</p></section>
<section id="liability" class="card"><h2>九、责任限制</h2><p>在法律允许的范围内,我们不对因以下原因造成的间接损失、预期利益损失或数据损失承担责任:设备自身缺陷或断电、网络和定位误差、第三方服务中断、用户错误操作、账号泄露、未经授权使用、不可抗力或其他非我们可合理控制的原因。</p><p>本条不排除或限制法律规定不得排除或限制的责任。若本 App 提供的具体服务另有单独规则,该规则与本协议不一致的,以单独规则为准。</p></section>
<section id="minor" class="card"><h2>十、未成年人保护</h2><p>本 App 可以面向未成年人。未成年人应在监护人指导下阅读并使用本服务,监护人应监督其账号、设备和个人信息使用情况。若监护人发现未成年人未经适当同意使用本服务或提交个人信息,请通过本协议列明的联系方式联系我们。</p></section>
<section id="termination" class="card"><h2>十一、协议终止与账号注销</h2><p>您可以停止使用本服务,并在 App 个人中心申请注销账号。申请注销前需取消所有已绑定设备;确认注销后,服务端将按实际流程删除用户信息。注销后账号及关联服务可能无法恢复,相关数据删除、备份清理和依法保留事项以隐私政策及实际数据处理规则为准。</p><p>如您严重违反本协议、法律法规或危害服务安全,我们可以暂停或终止向您提供全部或部分服务。协议终止后,依其性质应继续有效的条款仍然有效。</p></section>
<section id="changes" class="card"><h2>十二、协议更新</h2><p>我们可能因法律法规、业务变化、产品功能或安全需要更新本协议。重大变更将通过 App 弹窗、页面提示或其他适当方式通知,并在本页面标注最新版本和生效日期。更新后的协议生效后,您继续使用本服务即视为接受更新内容;如您不同意,应停止使用并注销账号。</p></section>
<section id="contact" class="card"><h2>十三、联系我们</h2><p><strong>协议主体:</strong>深圳市聚心时代科技有限公司<br><strong>联系邮箱:</strong><a href="mailto:huzuming2@gmail.com">huzuming2@gmail.com</a><br><strong>公司地址:</strong>深圳市宝安区沙井街道马安山社区马安山鞍胜路2号C栋203</p><p>如您对本协议、账号安全、设备服务或用户权利有疑问,可通过上述邮箱联系我们。我们将在合理期限内处理您的咨询或请求。</p><p><strong>生效日期:</strong>2026年10月1日</p></section>
<p><a class="back" href="#top">返回顶部 ↑</a></p>
</main>
</div>
<footer class="footer">JUMHABI 用户协议 · 版本 V1.0</footer>
</body>
</html>

View File

@@ -58,7 +58,7 @@ public interface AppUserApiService {
*
* @param phoneNumber 手机号
* @param rawPassword 明文密码
* @param nickName 昵称(为空时默认取手机号)
* @param nickName 昵称(为空时默认生成 {@code user_ + 当前时间戳})
* @return 新建用户主键
*/
Long registerByPhone(String phoneNumber, String rawPassword, String nickName);
@@ -82,6 +82,15 @@ public interface AppUserApiService {
*/
boolean existsByEmail(String email);
/**
* 更新 APP 用户邮箱;仅更新邮箱字段,昵称保持不变。
*
* @param userId 用户主键
* @param newEmail 新邮箱地址(已归一化)
* @return true 修改成功
*/
boolean updateEmail(Long userId, String newEmail);
/**
* 以邮箱注册一个 APP 用户(邮箱注册入口)。
* <p>
@@ -94,7 +103,7 @@ public interface AppUserApiService {
*
* @param email 邮箱地址(已归一化)
* @param rawPassword 明文密码
* @param nickName 昵称(为空时默认取邮箱)
* @param nickName 昵称(为空时默认生成 {@code user_ + 当前时间戳})
* @return 新建用户主键
*/
Long registerByEmail(String email, String rawPassword, String nickName);
@@ -109,7 +118,7 @@ public interface AppUserApiService {
boolean resetPassword(Long userId, String rawPassword);
/**
* 换绑手机号。
* 换绑手机号;仅更新手机号字段,昵称保持不变。
*
* @param userId 用户主键
* @param newPhoneNumber 新手机号

View File

@@ -80,6 +80,14 @@ public final class AppConstants {
*/
public static final String SCENE_BIND = "bind";
/**
* 场景:换绑前确认原手机号。
* <p>
* 仅登录后的 {@code POST /app/user/phone/old-code} 可发送;公共 {@code /app/auth/sms/code} 拒绝本场景,
* 避免客户端指定任意号码冒充原号通道。与 {@link #SCENE_REBIND}(新号)缓存 key 隔离。
*/
public static final String SCENE_REBIND_OLD = "rebindOld";
// ---------------- 协议类型 ----------------
/**
@@ -109,6 +117,21 @@ public final class AppConstants {
*/
public static final String SMS_FAIL_KEY_PREFIX = "app:sms:fail:";
/**
* 换绑原号核验状态 key 前缀,完整 key = 前缀 + userId。
* <p>
* {@code POST /app/user/phone/verify-old} 写入,{@code PUT /app/user/phone} 换绑成功后删除;
* TTL 与短信验证码有效期一致。
*/
public static final String REBIND_OLD_OK_KEY_PREFIX = "app:rebind:old-ok:";
/**
* 手机号绑定/换绑并发保护锁 key 前缀,完整 key = 前缀 + userId。
* <p>
* 将原号核验状态检查、手机号更新和状态失效串行化,避免同一账号并发换绑重复消费一次核验状态。
*/
public static final String PHONE_REBIND_LOCK_KEY_PREFIX = "app:user:phone-rebind:lock:";
/**
* 「错误尝试」限速窗口内允许的最大失败次数(P2 加固后语义)。
* <p>
@@ -160,4 +183,14 @@ public final class AppConstants {
*/
public static final String EMAIL_REGISTER_LOCK_KEY_PREFIX = "app:user:register:lock:email:";
/**
* 换绑原邮箱核验状态 key 前缀,完整 key = 前缀 + userId。
*/
public static final String EMAIL_REBIND_OLD_OK_KEY_PREFIX = "app:rebind:email:old-ok:";
/**
* 邮箱绑定/换绑并发保护锁 key 前缀,完整 key = 前缀 + userId。
*/
public static final String EMAIL_REBIND_LOCK_KEY_PREFIX = "app:user:email-rebind:lock:";
}

View File

@@ -73,16 +73,20 @@ public final class AppMsgConstants {
public static final String EMAIL_DOMAIN_NOT_ALLOWED = "该邮箱域名暂不支持注册";
/**
* 邮箱注册成功(提示继续绑定手机号)。
* <p>「注册后仍须绑手机号」为本迭代的账号规则,故注册成功文案直接给出下一步引导。
* 邮箱注册成功,注册后可以直接使用邮箱登录;绑定手机号仅在绑定设备前要求。
*/
public static final String EMAIL_REGISTER_SUCCESS = "注册成功,请绑定手机号";
public static final String EMAIL_REGISTER_SUCCESS = "注册成功,请登录";
/**
* 该账号尚未绑定手机号(绑定设备前的硬拦截文案)。
*/
public static final String PHONE_NOT_BOUND = "请先绑定手机号";
/**
* 当前账号尚未绑定邮箱,无法发送原邮箱核验码。
*/
public static final String EMAIL_NOT_BOUND = "请先绑定邮箱";
// ---------------- 账号 ----------------
/**
@@ -160,6 +164,36 @@ public final class AppMsgConstants {
*/
public static final String PHONE_SAME_AS_CURRENT = "新手机号与当前手机号相同";
/**
* 原手机号验证码校验成功(换绑第 1 步)。
*/
public static final String OLD_PHONE_VERIFY_SUCCESS = "验证成功";
/**
* 换绑第 2 步缺少有效的原号核验状态。
*/
public static final String OLD_PHONE_NOT_VERIFIED = "请先验证原手机号";
/**
* 邮箱更换成功。
*/
public static final String EMAIL_UPDATE_SUCCESS = "邮箱更换成功";
/**
* 新邮箱与当前邮箱相同。
*/
public static final String EMAIL_SAME_AS_CURRENT = "新邮箱与当前邮箱相同";
/**
* 原邮箱验证码校验成功。
*/
public static final String OLD_EMAIL_VERIFY_SUCCESS = "验证成功";
/**
* 换绑邮箱缺少有效的原邮箱核验状态。
*/
public static final String OLD_EMAIL_NOT_VERIFIED = "请先验证原邮箱";
/**
* 协议类型不合法。
* <p>TODO 阶段 7 按原型核对。

View File

@@ -107,15 +107,16 @@ public class AppAuthController extends BaseController {
*/
@PostMapping("/email/code")
public R<Void> sendEmailCode(@Validated @RequestBody AppEmailCodeBo bo) {
appAuthService.sendEmailCode(bo);
return R.ok(AppMsgConstants.EMAIL_CODE_SENT);
String code = appAuthService.sendEmailCode(bo);
// 开发环境 mock 模式与短信接口保持一致:把验证码放入 msg;真实邮件仍只返回标准成功文案。
return R.ok(code == null ? AppMsgConstants.EMAIL_CODE_SENT : code);
}
/**
* 邮箱注册。
* <p>
* 成功文案给出「请绑定手机号」引导:按本迭代账号规则,邮箱注册后须继续绑定手机号,
* 未绑手机号的账号无法绑定设备(服务端硬拦截,见 {@code IAppDeviceService#bind})。
* 邮箱注册完成后可直接使用邮箱登录;未绑定手机号的账号仅在绑定设备时受限
* (服务端硬拦截,见 {@code IAppDeviceService#bind})。
*/
@PostMapping("/email/register")
public R<Void> emailRegister(@Validated @RequestBody AppEmailRegisterBo bo) {

View File

@@ -1,10 +1,15 @@
package org.dromara.device.controller.app;
import cn.dev33.satoken.annotation.SaIgnore;
import lombok.RequiredArgsConstructor;
import org.dromara.common.core.domain.R;
import org.dromara.common.core.utils.MessageUtils;
import org.dromara.common.web.core.BaseController;
import org.dromara.device.constant.AppMsgConstants;
import org.dromara.device.domain.bo.AppOldPhoneCodeBo;
import org.dromara.device.domain.bo.AppOldEmailCodeBo;
import org.dromara.device.domain.bo.AppPasswordBo;
import org.dromara.device.domain.bo.AppEmailBo;
import org.dromara.device.domain.bo.AppPhoneBo;
import org.dromara.device.domain.vo.AppAgreementVo;
import org.dromara.device.domain.vo.AppUserProfileVo;
@@ -12,6 +17,7 @@ import org.dromara.device.service.IAppUserService;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
@@ -21,8 +27,8 @@ import org.springframework.web.bind.annotation.RestController;
/**
* APP 个人中心 Controller(前缀 {@code /app/user})。
* <p>
* 本组接口需登录态;当前用户取自 {@code LoginHelper.getUserId()}(登录标识 {@code app_user:{userId}}),
* 仅能操作本人数据,不做后台数据权限。
* 除协议查询接口外,本组接口均需登录态;当前用户取自 {@code LoginHelper.getUserId()}
* (登录标识 {@code app_user:{userId}}),仅能操作本人数据,不做后台数据权限。
*
* @author Kou
* @date 2026-09-16
@@ -53,7 +59,25 @@ public class AppUserController extends BaseController {
}
/**
* 换绑手机号(新手机号 + 验证码)。
* 向当前账号原手机号发送换绑确认验证码。
*/
@PostMapping("/phone/old-code")
public R<Void> sendOldPhoneCode() {
String code = appUserService.sendOldPhoneCode();
return R.ok(code == null ? MessageUtils.message("app.sms.code.sent") : code);
}
/**
* 校验原手机号验证码,通过后写入换绑核验状态,APP 再进入绑定新号页。
*/
@PostMapping("/phone/verify-old")
public R<Void> verifyOldPhone(@Validated @RequestBody AppOldPhoneCodeBo bo) {
appUserService.verifyOldPhone(bo);
return R.ok(AppMsgConstants.OLD_PHONE_VERIFY_SUCCESS);
}
/**
* 首次绑定或更换手机号(新手机号 + 验证码)。换绑须先完成原号核验。
*/
@PutMapping("/phone")
public R<Void> rebindPhone(@Validated @RequestBody AppPhoneBo bo) {
@@ -61,6 +85,34 @@ public class AppUserController extends BaseController {
return R.ok(AppMsgConstants.PHONE_UPDATE_SUCCESS);
}
/**
* 向当前账号原邮箱发送换绑确认验证码。
*/
@PostMapping("/email/old-code")
public R<Void> sendOldEmailCode() {
String code = appUserService.sendOldEmailCode();
// 模拟邮件模式把验证码放入 msg,真实邮件模式只返回通用成功文案。
return R.ok(code == null ? AppMsgConstants.EMAIL_CODE_SENT : code);
}
/**
* 校验原邮箱验证码,通过后才允许更换已有邮箱。
*/
@PostMapping("/email/verify-old")
public R<Void> verifyOldEmail(@Validated @RequestBody AppOldEmailCodeBo bo) {
appUserService.verifyOldEmail(bo);
return R.ok(AppMsgConstants.OLD_EMAIL_VERIFY_SUCCESS);
}
/**
* 首次绑定或更换邮箱(新邮箱 + 验证码)。
*/
@PutMapping("/email")
public R<Void> rebindEmail(@Validated @RequestBody AppEmailBo bo) {
appUserService.rebindEmail(bo);
return R.ok(AppMsgConstants.EMAIL_UPDATE_SUCCESS);
}
/**
* 注销账号(先解绑全部设备,再停用账号)。
*/
@@ -71,10 +123,11 @@ public class AppUserController extends BaseController {
}
/**
* 查询协议内容(URL + 版本 + 更新时间)。
* 查询协议内容(URL + 版本 + 更新时间),供登录、注册等未登录页面使用。
*
* @param type 协议类型:user / privacy
*/
@SaIgnore
@GetMapping("/agreements")
public R<AppAgreementVo> agreements(@RequestParam("type") String type) {
return R.ok(appUserService.agreements(type));

View File

@@ -0,0 +1,39 @@
package org.dromara.device.domain.bo;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Pattern;
import jakarta.validation.constraints.Size;
import lombok.Data;
import org.dromara.device.constant.AppConstants;
import java.io.Serial;
import java.io.Serializable;
/**
* APP 首次绑定或换绑邮箱入参。
*
* @author Kou
* @date 2026-09-23
*/
@Data
public class AppEmailBo implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 新邮箱地址。
*/
@NotBlank(message = "新邮箱不能为空")
@Size(max = 50, message = "邮箱长度不能超过{max}个字符")
@Pattern(regexp = AppConstants.EMAIL_REGEX, message = "请输入正确的邮箱地址")
private String newEmail;
/**
* 邮箱验证码(发送至新邮箱)。
*/
@NotBlank(message = "验证码不能为空")
@Pattern(regexp = AppConstants.SMS_CODE_REGEX, message = "验证码格式不正确")
private String code;
}

View File

@@ -14,9 +14,9 @@ import java.io.Serializable;
/**
* APP 邮箱注册入参。
* <p>
* <b>不含手机号</b>:按本迭代账号规则「注册后仍须绑手机号」,邮箱注册先建号
* ({@code phone_number} 为 {@code NULL}),再由 APP 引导调用 {@code PUT /app/user/phone}
* 完成绑定;未绑手机号的账号<b>无法绑定设备</b>(服务端硬拦截)。
* <b>不含手机号</b>:邮箱注册先建号({@code phone_number} 为 {@code NULL}),注册后可直接登录;
* 用户绑定设备前再按需调用 {@code PUT /app/user/phone} 完成手机号绑定,未绑手机号的账号
* <b>无法绑定设备</b>(服务端硬拦截)。
* <p>
* 协议勾选态由 APP 前端把关,服务端不落库(按《开发计划》§8.1)。
*
@@ -52,7 +52,7 @@ public class AppEmailRegisterBo implements Serializable {
private String password;
/**
* 昵称(选填,为空时默认取邮箱)。
* 昵称(选填,为空时默认生成 user_ 加当前时间戳)。
*/
@Xss(message = "昵称不能包含脚本字符")
@Size(max = 30, message = "昵称长度不能超过{max}个字符")

View File

@@ -0,0 +1,30 @@
package org.dromara.device.domain.bo;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Pattern;
import lombok.Data;
import org.dromara.device.constant.AppConstants;
import java.io.Serial;
import java.io.Serializable;
/**
* APP 换绑第 1 步:校验原邮箱验证码入参。
*
* @author Kou
* @date 2026-09-23
*/
@Data
public class AppOldEmailCodeBo implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 邮箱验证码(6 位数字,发送至账号原邮箱)。
*/
@NotBlank(message = "验证码不能为空")
@Pattern(regexp = AppConstants.SMS_CODE_REGEX, message = "验证码格式不正确")
private String oldCode;
}

View File

@@ -0,0 +1,32 @@
package org.dromara.device.domain.bo;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Pattern;
import lombok.Data;
import org.dromara.device.constant.AppConstants;
import java.io.Serial;
import java.io.Serializable;
/**
* APP 换绑第 1 步:校验原手机号验证码入参。
* <p>
* 验证码由 {@code POST /app/user/phone/old-code} 发到账号当前手机号(scene = rebindOld)。
*
* @author Kou
* @date 2026-09-22
*/
@Data
public class AppOldPhoneCodeBo implements Serializable {
@Serial
private static final long serialVersionUID = 1L;
/**
* 短信验证码(6 位数字,发送至账号原手机号)。
*/
@NotBlank(message = "验证码不能为空")
@Pattern(regexp = AppConstants.SMS_CODE_REGEX, message = "验证码格式不正确")
private String oldCode;
}

View File

@@ -47,7 +47,7 @@ public class AppRegisterBo implements Serializable {
private String password;
/**
* 昵称(选填,为空时默认取手机号)。
* 昵称(选填,为空时默认生成 user_ 加当前时间戳)。
*/
@Xss(message = "昵称不能包含脚本字符")
@Size(max = 30, message = "昵称长度不能超过{max}个字符")

View File

@@ -28,7 +28,7 @@ public class AppSmsCodeBo implements Serializable {
private String phoneNumber;
/**
* 场景:login / register / resetPwd / rebind。
* 场景:login / register / resetPwd / bind / rebind。{@code rebindOld} 仅登录后原号发码接口可用。
*/
@NotBlank(message = "{app.sms.scene.not.blank}")
private String scene;

View File

@@ -36,7 +36,7 @@ public class AppUserAdminVo implements Serializable {
private String userName;
/**
* 昵称(手机号注册默认取手机号;邮箱注册默认取邮箱)
* 昵称(注册时未填写则默认生成 user_ 加当前时间戳)
*/
private String nickName;

View File

@@ -45,8 +45,7 @@ public class AppUserProfileVo implements Serializable {
/**
* 是否已绑定手机号。
* <p>
* 供 APP 判断是否需强制引导绑手机号(账号规则:邮箱注册后仍须绑手机号,
* 未绑手机号的账号无法绑定设备)。
* 供 APP 在绑定设备前判断是否需要引导绑手机号;未绑手机号不影响登录和其他个人中心操作。
*/
private Boolean phoneBound;

View File

@@ -47,8 +47,9 @@ public class AppEmailService {
*
* @param email 邮箱地址(大小写不敏感)
* @param scene 场景(register / login / resetPwd)
* @return mock 模式下返回验证码供接口联调,真实邮件模式返回 {@code null}
*/
public void sendCode(String email, String scene) {
public String sendCode(String email, String scene) {
if (!EmailSceneEnum.isValid(scene)) {
throw new ServiceException(AppMsgConstants.EMAIL_SCENE_INVALID);
}
@@ -69,6 +70,8 @@ public class AppEmailService {
// 新码对应新计数:清零历史失败计数(错误的限速窗口也随新码重新起算)
RedisUtils.deleteObject(AppConstants.EMAIL_FAIL_KEY_PREFIX + scene + ":" + to);
send(to, scene, code);
// 仅模拟发送时向上返回验证码,避免真实邮件模式通过接口泄露验证码。
return cfg.isMock() ? code : null;
}
/**

View File

@@ -7,12 +7,11 @@ import org.dromara.common.core.utils.StringUtils;
/**
* APP 邮箱验证码场景枚举。
* <p>
* 场景编码<b>复用</b> {@code AppConstants.SCENE_*} 的取值(register / login / resetPwd),
* 场景编码<b>复用</b> {@code AppConstants.SCENE_*} 的取值(register / login / resetPwd / bind / rebind / rebindOld),
* 与短信通道保持一致的语义;但由于 Redis key 前缀不同({@code app:email:*} 与 {@code app:sms:*}),
* 两个通道的验证码与限流互不影响。
* <p>
* <b>为什么没有 rebind / bind</b>:手机号的绑定与换绑必须由<b>新手机号收到的短信验证码</b>证明归属,
* 邮箱验证码无法证明手机号归属,故邮箱通道不提供这两个场景。
* 邮箱换绑同样采用「原邮箱核验 + 新邮箱验证码」两步流程;首次绑定邮箱使用 bind 场景。
*
* @author Kou
* @date 2026-09-17
@@ -34,7 +33,22 @@ public enum EmailSceneEnum {
/**
* 忘记密码。
*/
RESET_PWD("resetPwd", "忘记密码");
RESET_PWD("resetPwd", "忘记密码"),
/**
* 首次绑定邮箱。
*/
BIND("bind", "绑定邮箱"),
/**
* 更换已有邮箱。
*/
REBIND("rebind", "换绑邮箱"),
/**
* 换绑前确认原邮箱。
*/
REBIND_OLD("rebindOld", "验证原邮箱");
/**
* 场景编码。

View File

@@ -40,7 +40,12 @@ public enum SmsSceneEnum {
/**
* 绑定手机(首次绑定:邮箱注册的账号补绑手机号时使用)。
*/
BIND("bind", "绑定手机");
BIND("bind", "绑定手机"),
/**
* 换绑前确认原手机号(仅登录后的原号发码接口使用)。
*/
REBIND_OLD("rebindOld", "确认原手机号");
/**
* 场景编码。

View File

@@ -68,14 +68,15 @@ public interface IAppAuthService {
// ---------------- 邮箱通道(迭代:邮箱注册) ----------------
/**
* 发送邮箱验证码(6 位、场景化 60 秒限流、5 分钟有效)。
* 发送邮箱验证码(6 位、场景化 60 秒限流、5 分钟有效);模拟模式返回验证码,真实发送模式返回 {@code null}。
*
* @param bo 验证码入参(邮箱 + 场景)
* @param bo 邮箱验证码请求
* @return 模拟验证码或 {@code null}
*/
void sendEmailCode(AppEmailCodeBo bo);
String sendEmailCode(AppEmailCodeBo bo);
/**
* 邮箱注册(注册后账号尚无手机号,须按账号规则继续绑定手机号)。
* 邮箱注册(注册后可直接邮箱登录,绑定手机号仅在绑定设备前要求)。
*
* @param bo 注册入参
*/

View File

@@ -1,6 +1,9 @@
package org.dromara.device.service;
import org.dromara.device.domain.bo.AppOldPhoneCodeBo;
import org.dromara.device.domain.bo.AppOldEmailCodeBo;
import org.dromara.device.domain.bo.AppPasswordBo;
import org.dromara.device.domain.bo.AppEmailBo;
import org.dromara.device.domain.bo.AppPhoneBo;
import org.dromara.device.domain.vo.AppAgreementVo;
import org.dromara.device.domain.vo.AppUserProfileVo;
@@ -28,12 +31,49 @@ public interface IAppUserService {
void updatePassword(AppPasswordBo bo);
/**
* 换绑手机号(新手机号 + 验证码)。
* 向当前账号原手机号发送换绑确认验证码(scene = rebindOld)。
*
* @return mock 模式下返回验证码,真实短信模式返回 {@code null}
*/
String sendOldPhoneCode();
/**
* 校验原手机号验证码,通过后写入换绑核验状态。
*
* @param bo 原号验证码
*/
void verifyOldPhone(AppOldPhoneCodeBo bo);
/**
* 绑定或换绑手机号(新手机号 + 验证码)。
* <p>
* 已有手机号的换绑必须先通过 {@link #verifyOldPhone} 取得核验状态。
*
* @param bo 换绑入参
*/
void rebindPhone(AppPhoneBo bo);
/**
* 向当前账号原邮箱发送换绑确认验证码。
*
* @return mock 模式下返回验证码,真实邮件模式返回 {@code null}
*/
String sendOldEmailCode();
/**
* 校验原邮箱验证码,通过后写入换绑核验状态。
*
* @param bo 原邮箱验证码
*/
void verifyOldEmail(AppOldEmailCodeBo bo);
/**
* 首次绑定或更换邮箱;已有邮箱的换绑必须先通过原邮箱核验。
*
* @param bo 邮箱换绑入参
*/
void rebindEmail(AppEmailBo bo);
/**
* 注销账号:先解绑其下全部设备,再停用账号,最后按 loginId 全端下线。
* <p>

View File

@@ -67,6 +67,9 @@ public class AppAuthServiceImpl implements IAppAuthService {
*/
@Override
public String sendSmsCode(AppSmsCodeBo bo) {
if (AppConstants.SCENE_REBIND_OLD.equals(bo.getScene())) {
throw new ServiceException(AppMsgConstants.SMS_SCENE_INVALID);
}
return appSmsService.sendCode(AppPhoneNumbers.canonical(bo.getPhoneNumber()), bo.getScene());
}
@@ -180,8 +183,8 @@ public class AppAuthServiceImpl implements IAppAuthService {
* @param bo 验证码入参(邮箱 + 场景)
*/
@Override
public void sendEmailCode(AppEmailCodeBo bo) {
appEmailService.sendCode(bo.getEmail(), bo.getScene());
public String sendEmailCode(AppEmailCodeBo bo) {
return appEmailService.sendCode(bo.getEmail(), bo.getScene());
}
/**

View File

@@ -117,10 +117,8 @@ public class AppDeviceServiceImpl implements IAppDeviceService {
/**
* 绑定设备(条件更新防并发双绑;成功才写 bind 流水)。
* <p>
* <b>前置硬约束(本迭代新增)</b>:账号须已绑定手机号。邮箱注册的账号在建号时
* {@code phone_number} 为空,按账号规则「注册后仍须绑手机号」,
* 此处<b>服务端拦截</b>而非依赖前端引导——否则「必须绑手机号」只是产品约定,
* 绕过 APP 直接调用接口即可跳过。
* <b>前置硬约束</b>:账号须已绑定手机号。邮箱注册账号可以先登录和使用其他 APP 功能,
* 但在绑定设备时由服务端拦截未绑定手机号的请求,避免绕过前端直接调用接口。
*
* @param bo 绑定入参(imei + name)
* @param userId 当前用户主键

View File

@@ -7,11 +7,15 @@ import org.dromara.common.core.enums.UserType;
import org.dromara.common.core.exception.ServiceException;
import org.dromara.common.core.utils.DesensitizedUtils;
import org.dromara.common.core.utils.StringUtils;
import org.dromara.common.redis.utils.RedisUtils;
import org.dromara.common.satoken.utils.LoginHelper;
import org.dromara.device.config.AppProperties;
import org.dromara.device.constant.AppConstants;
import org.dromara.device.constant.AppMsgConstants;
import org.dromara.device.constant.DeviceMsgConstants;
import org.dromara.device.domain.bo.AppOldPhoneCodeBo;
import org.dromara.device.domain.bo.AppOldEmailCodeBo;
import org.dromara.device.domain.bo.AppEmailBo;
import org.dromara.device.domain.bo.AppPasswordBo;
import org.dromara.device.domain.bo.AppPhoneBo;
import org.dromara.device.domain.vo.AppAgreementVo;
@@ -20,11 +24,15 @@ import org.dromara.device.service.IAppUserService;
import org.dromara.device.service.IDeviceBindService;
import org.dromara.device.sms.AppPhoneNumbers;
import org.dromara.device.sms.AppSmsService;
import org.dromara.device.email.AppEmailService;
import org.dromara.system.api.AppUserApiService;
import org.dromara.system.api.UserService;
import org.dromara.system.api.domain.UserDTO;
import org.redisson.api.RLock;
import org.springframework.stereotype.Service;
import java.time.Duration;
/**
* APP 个人中心服务实现。
* <p>
@@ -52,6 +60,7 @@ public class AppUserServiceImpl implements IAppUserService {
private final UserService userService;
private final IDeviceBindService deviceBindService;
private final AppSmsService appSmsService;
private final AppEmailService appEmailService;
private final AppProperties appProperties;
/**
@@ -71,8 +80,7 @@ public class AppUserServiceImpl implements IAppUserService {
vo.setNickName(user.getNickName());
vo.setPhoneNumber(DesensitizedUtils.mobilePhone(user.getPhoneNumber()));
vo.setEmail(DesensitizedUtils.email(user.getEmail()));
// 账号规则:邮箱注册的账号注册后仍须绑定手机号;未绑定时 APP 需据此强制引导,
// 且服务端已禁止未绑手机号的账号绑定设备(见 IAppDeviceService#bind)。
// 邮箱注册账号可以先登录和使用个人中心;未绑定手机号时仅禁止绑定设备,绑定设备前再引导补绑。
vo.setPhoneBound(StringUtils.isNotBlank(user.getPhoneNumber()));
vo.setUserType(user.getUserType());
vo.setCreateTime(user.getCreateTime());
@@ -96,27 +104,66 @@ public class AppUserServiceImpl implements IAppUserService {
appUserApiService.resetPassword(userId, bo.getNewPassword());
}
/**
* 向当前账号原手机号发送换绑确认验证码。
*
* @return mock 模式下返回验证码,真实短信模式返回 {@code null}
*/
@Override
public String sendOldPhoneCode() {
UserDTO current = requireCurrentUser();
return appSmsService.sendCode(requireBoundPhone(current), AppConstants.SCENE_REBIND_OLD);
}
/**
* 校验原手机号验证码,通过后写入 Redis 核验状态(TTL 与短信有效期一致)。
*
* @param bo 原号验证码
*/
@Override
public void verifyOldPhone(AppOldPhoneCodeBo bo) {
Long userId = currentUserId();
RLock lock = RedisUtils.getClient().getLock(AppConstants.PHONE_REBIND_LOCK_KEY_PREFIX + userId);
lock.lock();
try {
// 与换绑共用用户锁,避免核验状态在换绑成功删除后又被并发写回。
UserDTO current = requireCurrentUser();
appSmsService.verifyCode(requireBoundPhone(current), AppConstants.SCENE_REBIND_OLD, bo.getOldCode());
RedisUtils.setCacheObject(AppConstants.REBIND_OLD_OK_KEY_PREFIX + userId, Boolean.TRUE,
Duration.ofMinutes(appProperties.getSms().getExpiryMinutes()));
} finally {
if (lock.isHeldByCurrentThread()) {
lock.unlock();
}
}
}
/**
* 绑定 / 换绑手机号:先拦截「新号==当前号」,再校验新号未被占用,再校验新号收到的验证码,最后落库。
* <p>
* <b>场景自适应(本迭代新增)</b>:按当前账号是否已有手机号选择验证码场景——
* 已有手机号的换绑必须先通过 {@link #verifyOldPhone} 取得核验状态;首次绑定不查该状态。
* <p>
* <b>场景自适应</b>:按当前账号是否已有手机号选择验证码场景——
* <ul>
* <li>当前无手机号(邮箱注册的账号)→ 场景 {@link AppConstants#SCENE_BIND}「绑定手机」;</li>
* <li>当前已有手机号 → 场景 {@link AppConstants#SCENE_REBIND}「换绑手机」(原有行为不变)。</li>
* <li>当前已有手机号 → 场景 {@link AppConstants#SCENE_REBIND}「换绑手机」;</li>
* </ul>
* 两个场景的验证码缓存 key 互相隔离,故 APP 必须按账号当前状态请求对应场景的验证码,
* 用错场景会得到「验证码已过期」。这样划分是为了让「首次绑定」与「更换手机号」在审计与文案上可区分。
*
* @param bo 换绑入参
*/
@Override
public void rebindPhone(AppPhoneBo bo) {
Long userId = currentUserId();
UserDTO current = userService.selectById(userId);
if (current == null) {
throw new ServiceException(AppMsgConstants.NOT_LOGIN);
}
RLock lock = RedisUtils.getClient().getLock(AppConstants.PHONE_REBIND_LOCK_KEY_PREFIX + userId);
lock.lock();
try {
// 锁内重新读取账号,保证核验状态检查与手机号更新针对同一份最新账号数据。
UserDTO current = requireCurrentUser();
boolean firstBind = StringUtils.isBlank(current.getPhoneNumber());
String rebindOldVerifiedKey = AppConstants.REBIND_OLD_OK_KEY_PREFIX + userId;
if (!firstBind && RedisUtils.getCacheObject(rebindOldVerifiedKey) == null) {
throw new ServiceException(AppMsgConstants.OLD_PHONE_NOT_VERIFIED);
}
String newPhone = AppPhoneNumbers.canonical(bo.getNewPhoneNumber());
// P3-6:新号与当前号相同时给出精确文案(原先 existsByPhone 命中自身 → 误报「手机号已注册」)
// 首次绑定时当前号为空,不存在「与当前号相同」的情形,故仅在换绑分支判断。
@@ -128,7 +175,92 @@ public class AppUserServiceImpl implements IAppUserService {
}
appSmsService.verifyCode(newPhone,
firstBind ? AppConstants.SCENE_BIND : AppConstants.SCENE_REBIND, bo.getCode());
// 换绑只更新手机号,昵称保持用户原值,不重新生成默认昵称。
appUserApiService.updatePhone(userId, newPhone);
if (!firstBind) {
// 与上面的状态检查处于同一用户锁内,确保一次核验只允许一次换绑成功。
RedisUtils.deleteObject(rebindOldVerifiedKey);
}
} finally {
if (lock.isHeldByCurrentThread()) {
lock.unlock();
}
}
}
/**
* 向当前账号原邮箱发送换绑确认验证码。
*
* @return mock 模式下返回验证码,真实邮件模式返回 {@code null}
*/
@Override
public String sendOldEmailCode() {
UserDTO current = requireCurrentUser();
return appEmailService.sendCode(requireBoundEmail(current), AppConstants.SCENE_REBIND_OLD);
}
/**
* 校验原邮箱验证码,通过后写入 Redis 核验状态;状态与邮箱换绑共用同一把用户锁。
*
* @param bo 原邮箱验证码
*/
@Override
public void verifyOldEmail(AppOldEmailCodeBo bo) {
Long userId = currentUserId();
RLock lock = RedisUtils.getClient().getLock(AppConstants.EMAIL_REBIND_LOCK_KEY_PREFIX + userId);
lock.lock();
try {
UserDTO current = requireCurrentUser();
appEmailService.verifyCode(requireBoundEmail(current), AppConstants.SCENE_REBIND_OLD, bo.getOldCode());
RedisUtils.setCacheObject(AppConstants.EMAIL_REBIND_OLD_OK_KEY_PREFIX + userId, Boolean.TRUE,
Duration.ofMinutes(appProperties.getEmail().getExpiryMinutes()));
} finally {
if (lock.isHeldByCurrentThread()) {
lock.unlock();
}
}
}
/**
* 绑定 / 换绑邮箱:先校验原邮箱核验状态,再校验新邮箱唯一性与验证码,最后更新账号。
* <p>
* 当前账号没有邮箱时视为首次绑定,不要求原邮箱核验,验证码场景使用 bind;已有邮箱时使用 rebind。
*
* @param bo 新邮箱与验证码
*/
@Override
public void rebindEmail(AppEmailBo bo) {
Long userId = currentUserId();
RLock lock = RedisUtils.getClient().getLock(AppConstants.EMAIL_REBIND_LOCK_KEY_PREFIX + userId);
lock.lock();
try {
UserDTO current = requireCurrentUser();
boolean firstBind = StringUtils.isBlank(current.getEmail());
String oldVerifiedKey = AppConstants.EMAIL_REBIND_OLD_OK_KEY_PREFIX + userId;
if (!firstBind && RedisUtils.getCacheObject(oldVerifiedKey) == null) {
throw new ServiceException(AppMsgConstants.OLD_EMAIL_NOT_VERIFIED);
}
String newEmail = appEmailService.normalize(bo.getNewEmail());
if (!firstBind && StringUtils.equals(current.getEmail(), newEmail)) {
throw new ServiceException(AppMsgConstants.EMAIL_SAME_AS_CURRENT);
}
if (appUserApiService.existsByEmail(newEmail)) {
throw new ServiceException(DeviceMsgConstants.EMAIL_REGISTERED);
}
appEmailService.verifyCode(newEmail,
firstBind ? AppConstants.SCENE_BIND : AppConstants.SCENE_REBIND, bo.getCode());
// 换绑只更新邮箱,昵称保持用户原值,不重新生成默认昵称。
if (!appUserApiService.updateEmail(userId, newEmail)) {
throw new ServiceException(AppMsgConstants.NOT_LOGIN);
}
if (!firstBind) {
RedisUtils.deleteObject(oldVerifiedKey);
}
} finally {
if (lock.isHeldByCurrentThread()) {
lock.unlock();
}
}
}
/**
@@ -198,4 +330,26 @@ public class AppUserServiceImpl implements IAppUserService {
return userId;
}
private UserDTO requireCurrentUser() {
UserDTO current = userService.selectById(currentUserId());
if (current == null) {
throw new ServiceException(AppMsgConstants.NOT_LOGIN);
}
return current;
}
private String requireBoundPhone(UserDTO current) {
if (StringUtils.isBlank(current.getPhoneNumber())) {
throw new ServiceException(AppMsgConstants.PHONE_NOT_BOUND);
}
return current.getPhoneNumber();
}
private String requireBoundEmail(UserDTO current) {
if (StringUtils.isBlank(current.getEmail())) {
throw new ServiceException(AppMsgConstants.EMAIL_NOT_BOUND);
}
return appEmailService.normalize(current.getEmail());
}
}

View File

@@ -47,7 +47,7 @@ public class AppSmsService {
* 生成并按场景发送短信验证码(含 60 秒重发限流)。
*
* @param phoneNumber 手机号
* @param scene 场景(login / register / resetPwd / rebind)
* @param scene 场景(login / register / resetPwd / bind / rebind / rebindOld)
* @return mock 模式下返回验证码供接口联调,真实短信模式返回 {@code null}
*/
public String sendCode(String phoneNumber, String scene) {

View File

@@ -46,6 +46,13 @@ public class AppUserApiServiceImpl implements AppUserApiService {
*/
private static final String USER_NAME_PREFIX = "app_";
/**
* 生成 APP 用户默认昵称,避免直接暴露手机号或邮箱。
*/
private static String defaultNickName() {
return "user_" + System.currentTimeMillis();
}
private final SysUserMapper userMapper;
/**
@@ -138,11 +145,12 @@ public class AppUserApiServiceImpl implements AppUserApiService {
* <li>与后台 {@code sys_user} 的账号名冲突需其恰好命名为 {@code app_<雪花ID>},非自然产生。</li>
* </ul>
* 说明:APP 登录仅依赖 {@code phone_number}(见 {@code selectByPhone}),不依赖 {@code user_name};
* 展示用昵称取 {@code nickName}(默认手机号),故 user_name 采用内部派生值不影响用户展示。
* 展示用昵称取 {@code nickName}(未传时默认生成 {@code user_ + 当前时间戳}),故 user_name
* 采用内部派生值不影响用户展示。
*
* @param phoneNumber 手机号
* @param rawPassword 明文密码
* @param nickName 昵称(为空时默认取手机号)
* @param nickName 昵称(为空时默认生成 {@code user_ + 当前时间戳})
* @return 新建用户主键
*/
@Override
@@ -151,7 +159,7 @@ public class AppUserApiServiceImpl implements AppUserApiService {
SysUser user = new SysUser();
user.setUserId(userId);
user.setUserName(USER_NAME_PREFIX + userId);
user.setNickName(StringUtils.isBlank(nickName) ? phoneNumber : nickName);
user.setNickName(StringUtils.isBlank(nickName) ? defaultNickName() : nickName);
user.setPhoneNumber(phoneNumber);
user.setUserType(UserType.APP_USER.getUserType());
user.setPassword(BCrypt.hashpw(rawPassword));
@@ -210,6 +218,22 @@ public class AppUserApiServiceImpl implements AppUserApiService {
.exists();
}
/**
* 更新 APP 用户邮箱;调用方负责完成验证码和唯一性校验。
* <p>仅写入邮箱字段,不改动昵称及其他用户资料。</p>
*/
@Override
public boolean updateEmail(Long userId, String newEmail) {
if (userId == null || StringUtils.isBlank(newEmail)) {
return false;
}
return userMapper.lambda()
.set(SysUser::getEmail, newEmail)
.eq(SysUser::getUserId, userId)
.eq(SysUser::getUserType, UserType.APP_USER.getUserType())
.updateCount() > 0;
}
/**
* 以邮箱注册一个 APP 用户。
* <p>
@@ -224,7 +248,7 @@ public class AppUserApiServiceImpl implements AppUserApiService {
*
* @param email 邮箱地址(已归一化)
* @param rawPassword 明文密码
* @param nickName 昵称(为空时默认取邮箱)
* @param nickName 昵称(为空时默认生成 {@code user_ + 当前时间戳})
* @return 新建用户主键
*/
@Override
@@ -233,7 +257,7 @@ public class AppUserApiServiceImpl implements AppUserApiService {
SysUser user = new SysUser();
user.setUserId(userId);
user.setUserName(USER_NAME_PREFIX + userId);
user.setNickName(StringUtils.isBlank(nickName) ? email : nickName);
user.setNickName(StringUtils.isBlank(nickName) ? defaultNickName() : nickName);
user.setEmail(email);
user.setUserType(UserType.APP_USER.getUserType());
user.setPassword(BCrypt.hashpw(rawPassword));
@@ -271,7 +295,7 @@ public class AppUserApiServiceImpl implements AppUserApiService {
}
/**
* 换绑手机号。
* 换绑手机号;仅写入手机号字段,不改动昵称及其他用户资料。
*
* @param userId 用户主键
* @param newPhoneNumber 新手机号