添加登录功能

This commit is contained in:
zpx committed 2026-11-20 15:13:11 +08:00
commit a3f61a29d0
120 files changed
+3974

No files matched your search

+68
View File
@@ -0,0 +1,68 @@
# Fruit Pop 游客登录
本阶段仅实现登录场景、两步游客认证及本地会话保存,不包含加载页或游戏主界面。
## 场景与美术
- 启动场景为 assets/Welcome.scene;项目设计分辨率为 1080×1920。
- WelcomeComposition 下的 BrandMark、FruitArrangement、GuestAccess 是独立可编辑节点。
- 使用未裁剪透明切图,位置和尺寸来自新版 1080×1920 参考图的多尺度像素匹配。
- OrchardBackdrop 使用装饰背景,位于主体之后;长短屏等比覆盖,不拉伸前景。
- Canvas 保存尺寸为 1080×1920,位置为 (540, 960),根 Widget 已取消旧屏幕尺寸对齐。
- GuestReassurance、PrivacyLink、TermsLink 和 LegalDivider 为独立可编辑文字;链接带下划线。
- 导入后的目录和图片已重新命名;原始美术文件保持不变。
- WelcomeViewport 对长屏固定宽度、短屏固定高度,完整保留画布并避免切图变形。
## 模块职责 / Module responsibilities
- GuestContracts:类型、端口与固定错误消息 / Types, ports and fixed error messages.
- GuestSignature:白名单字段的 HMAC-SHA256 签名 / HMAC-SHA256 signing of allowed fields.
- GuestHttpClient:请求、响应、超时和取消 / Requests, responses, deadlines and cancellation.
- GuestSessionStore:独立身份命名空间及会话提交 / Isolated identity namespace and session persistence.
- GuestLoginService:两步认证编排 / Two-step authentication orchestration.
- GuestLoginPresenter:交互状态、防连点及生命周期 / Interaction state, duplicate-click prevention and lifecycle.
- GuestRuntime:连接平台、配置与依赖 / Connect platform capabilities, configuration and dependencies.
- GuestLoginView:场景控件绑定与展示 / Scene bindings and state rendering.
- GuestLegalLinks:法律链接独立交互,未配置网址时仅提示 / Independent legal links with honest missing-URL feedback.
- WelcomeLayoutAuthoring:显式编辑校准,不在运行时生成界面 / Explicit editor calibration without runtime UI generation.
- WelcomeViewport:画布适配 / Viewport adaptation.
## 协议与配置
按已确认要求沿用参考项目 HTTPS 服务、VeryWellSlots 服务端 pkg 与本机签名配置。
本机 common-key/common_key.json 已复制至本项目并加入忽略规则;测试不读取该文件。
1. POST /account/v2/guest/login:携带 X-Timestamp、X-Nonce、X-Sign,不携带 Authorization。
2. POST /account/login:使用同一个 guest_id 与 pkg,不携带签名头,取得完整 token 后保存。
签名使用 LF 分隔的六行,空 uid 为第五行;字段按键排序、false 参与签名、无额外 URL 编码。
每次按钮登录重新认证;游客身份保持不变,nonce 重新生成,不复用缓存 token 作为认证成功。
本地存储前缀为 fruit-pop.auth,按服务地址与产品隔离。重登失败不覆盖旧成功会话。
首次调用者拥有同一服务实例的合并请求及其取消信号;界面层禁止并发提交。
认证成功后显示 Signed in successfully. 并发出不含 token 的 guest-authenticated 事件,供后续加载功能衔接。
当前不添加加载场景,也不自动跳转。
## 验证记录
- pnpm@11.17.0 安装;类型检查、离线行为测试与布局契约测试。
- web-mobile 发布构建成功,输出 build/web-mobile-guest-login。
- 发布页真实游客认证:两步接口均 HTTP 200,界面进入认证成功状态,身份与保存会话一致。
- 真实服务存在响应波动,后续一次请求达到超时;按钮恢复可重试,不把失败显示为成功。
- 发布页注入验签失败响应:固定提示、恢复按钮、旧会话保留;测试完成恢复真实网络实现。
- 540×960、390×844、390×640 及横向窗口完成运行时结构检查,切图不拉伸且完整可见。
当前验收范围为网页发布版。没有生成原生子工程或 Android 安装包;原生安全随机、网络适配及真机验证留到对应阶段。
客户端签名材料会进入编译产物;忽略本机文件只防止误提交,不表示客户端密钥不可提取。
## 新版参考图修复
- 改用完整装饰背景,重新校准 Logo、水果和更宽的游客按钮。
- 加入 No account needed 和法律链接;尚无真实政策网址时显示固定提示,不虚构跳转。
- 登录状态提示移至说明文字与法律链接之间。
- 已同步保存画布与项目设计分辨率;类型、布局和行为验证在本轮重新执行。
- 最终发布目录为 build/web-mobile-welcome-revised;类型检查和 15 项测试全部通过。
- 新版发布页两步真实游客认证均返回 HTTP 200,认证完成状态和会话保存通过核对。
- 540×960、390×844、390×640 核对前景完整、不变形、背景覆盖完整;法律链接点击提示正确。
- 自动验收页处于隐藏状态时会暂停帧回调,仅测试页面临时恢复调度;该处理未进入项目代码或构建产物。
- 旧输出目录重建曾因 ENOTEMPTY 失败;改用新的最终目录成功构建,未删除旧产物。