创建日期:2026-10-09
更新日期:2026-10-29
状态:注册与会员报单已共用页面、表单、商品及支付弹窗,通过两条原路由指定模式;真实后端、订单确认和支付待联调。
第 1~6 节描述当前源码,第 7 节保留最初迁移时的验证记录,第 8 节说明本次文档核对范围。早期会员报单、删除订单、成功倒计时等行为不能继续作为当前游客注册页的实现说明。
最新推荐人国家绑定与分步展示规则、验证结果见第 11 节。
初始授权:用户要求将 src/views/user/welcome-pack.vue 的功能迁入新注册 UI,旧页不动、优先使用 Element UI。2026-10-28 按用户批准方案,两条入口已统一挂载 src/ui-refactor/views/welcome-pack/MemberWelcomePack.vue,共享视图仍位于 src/ui-refactor/views/signup/SignupPage.vue。
后续实现:按后续需求接入游客专用接口、固定国家 / 语言选项,并调整游客支付流程;本轮仅复用页面与组件,API 方法仍在 src/api/user.js,旧会员接口与旧页保留。当前结构与完整验证见 共用页面说明。
用户提供的注册参考页、截图及本地 water1009 v1/water/signup.html 用于分组、卡片、商品排列和视觉参考。参考中的脚本、模拟会员、商品数据、校验与支付行为不构成业务需求,也未引入生产代码。
| 文件 | 职责 |
|---|---|
| SignupPage.vue | 唯一业务视图,共用会员表单、商品选择、市场价计算及支付展示;游客保留 Sign in 和查询参数,会员报单按最新规则同样取 MARKET_PRICE |
| welcomePackRegistration.js | 维护游客草稿、查询、提交及支付状态;商品与金额处理已移入共享视图 |
| SignupProducts.vue | 通过 props 展示商品、数量、选择和汇总,发出 toggle、quantity、details 事件 |
| SignupDialogs.vue | 保留旧 props/events 的薄适配器,实际展示由共用 WelcomePackDialogs 负责;支付弹窗不展示邮箱 |
| GuestPaystack.js | 局部继承 vue-paystack,加载 V2 SDK,以服务端 accessCode 恢复交易 |
| UiSectionCard.vue | 共享分组卡片,复用 Element Card,透传属性、事件与插槽 |
| signup.spec.js | 游客接口、草稿标识、计价、提交校验、订单复用和支付回调的回归用例 |
| guestPaystack.spec.js | V2 SDK 加载、accessCode 恢复、取消重开、错误和回调的回归用例 |
已确认:未通过 extends 或直接挂载旧 SFC 复用页面,因为旧页包含未限定作用域的表格、Tabs、Radio 样式,直接导入会污染新页面。独立业务快照避免加载这些样式,也遵守旧文件保持不动的约束。
维护边界:游客注册与会员报单通过固定模式共用界面和计价实现,各自接口、初始化和支付协议由局部适配模块保留;没有新增认证缓存或改造旧页。
| 分组 | 字段与行为 | Element UI |
|---|---|---|
| Basic Information | 国家、语言、会员编号、等级、报单中心编号;保留编号只读与中心禁用条件 | Form、FormItem、Row、Col、Select、Input |
| Products | 真实接口商品、图片、编号、销售价、市场价、BV、详情、选择与数量、汇总 | Card、Image、Tag、Button、InputNumber、Empty |
| Network Information | 推荐人和实际推荐人均必填、可修改;邀请链接的 ref 默认填入两项;更改推荐人清空原实际推荐人;查询姓名仍写入状态,当前没有姓名展示控件 |
Input |
| Personal Information | 姓名、手机、邮箱、登录 / 支付密码、收件人和收件电话 | Input;沿用当前字段绑定与 maxlength,不将早期密码显隐记录当成当前配置 |
| Delivery Method | 原 express / pickup 值及地址禁用行为 |
RadioGroup、Radio |
| Address Details | 原地区级联值、详细地址、城市、LGA | Cascader、Input、Textarea |
| Bank Information | 银行、账户姓名、账号;虽未出现在参考截图中,仍保留旧页功能 | Select、Input |
| Payment Information | 后端支付方式、现金余额与 Paystack 提示;提交后打开支付确认弹窗 | RadioGroup、Radio、Alert、Dialog、Button |
button-variant Sass mixin,仅传入深蓝色,沿用其悬停、焦点、按下与禁用状态算法;不加载第二套主题或手写控件行为。.ng-public-layout 与 scoped 样式;当前支付关闭不再使用删除订单确认框。for 与选择框 id 配对,用于标签关联,不能仅因业务代码未引用而判定无用。此前已移除未使用的表单 ref、两段注释展示代码及五项未读取的旧表单默认状态;提交 payload 中的银行地区、配送地区和 location 字段仍保留。以当前源码为准;旧计价与字段兼容规则继续保留,游客身份和支付按后续需求调整。
620699181539139625)和 UAE(620699181539139643),均默认使用已有 English 选项;语言仍为原中文 / English。不请求 getCountries / getLanguages,不依赖 Vuex 列表缓存,不修改全局当前语言。data.countryId 匹配上述固定国家 ID,自动选中且只读;不依据会员编号前缀推断。匹配后调用 GET /v1/user/guest-dec?countryId=...,读取 data.draft,会员编号来自 draft.insertUserName,币种优先 draft.currency,无值时回退首个商品的 CODE。支付方式优先 payList,兼容旧 sellType[0].sell_type。GET /v1/user/guest-full-info,参数 userName;实际推荐人使用 GET /v1/user/guest-inspect-network,参数 recommenderName / recommenderActualName;姓名读取 data.REAL_NAME。这些方法放在 src/api/user.js,不影响旧会员查询方法。国家缺失、非支持国家或推荐人查询失败时不初始化注册草稿、不允许提交。goodsId 与 goodsNum 数组,decWay: '2'、decType: 'normal'、location: 1。POST /v1/user/guest-dec。在原业务字段之外,将 draftId 与 accessToken 放在请求体最外层,不嵌套为 draft。两项缺失时阻止提交;草稿只保存在页面内存,不写入会员缓存。response.data || response 读取订单,包含 orderSn、amount、currency、reference、accessCode 等支付信息;缺少 accessCode 或 reference 时显示错误。authorizationUrl 即使返回,当前也不用于整页跳转。GuestPaystack 加载 https://js.paystack.co/v2/inline.js,调用 resumeTransaction(accessCode)。金额用于展示,不由前端重新创建交易或按旧流程乘 100 初始化扣款;交易金额与币种由服务端交易决定。POST /v1/user/guest-dec,成功后使用本次返回的支付信息打开弹窗;请求中阻止重复点击,失败或缺少交易标识时不打开旧支付信息。是否复用已有后台订单由接口决定。SDK 内仍防止重复打开,支付回调的 reference 必须与最新订单一致;随后显示 Payment Successful 弹窗,点击 Got it 后使用 replace 跳转 /login,保留原查询参数,没有自动跳转或倒计时。取消支付、请求失败或回调不匹配时不显示成功弹窗、不跳转。POST /v1/user/guest-dec 请求的 insertUserName 快照,不依赖成功响应或支付回调返回会员编号,也不读取之后被修改的表单。提供 Copy 按钮并复用既有剪贴板反馈,缺失编号显示 — 且禁用复制。弹窗不允许遮罩、Escape 或关闭按钮跳过确认;重复成功回调不重开弹窗、不重复导航。paymentComplete 后提交按钮显示 Registration Complete! 并禁用。成功触发点仍是匹配的前端支付回调,本次不新增服务端确认查询。邀请链接形如 /#/login?ref=会员ID,登录页 Register 已透传查询参数。注册页创建时读取单个字符串 ref,去掉首尾空格后同时作为 form.recUserName 和 form.conUserName 的默认值,并查询推荐人国家;此初始查询保留两项预填值。没有有效 ref 时留空,不猜测推荐人。手动更改推荐人仍会清空实际推荐人,需要重新填写并确认关系;输入新推荐人时立即清空旧国家、草稿、商品选择、地区 / 银行选项和旧支付信息。独立请求序号防止较早的推荐人或草稿响应覆盖新结果,销毁时忽略迟到响应。Save 和 Continue Payment 都再次检查当前推荐人及国家是否与已验证结果一致,再传递用户当前填写的两项。
2026-10-29 按用户提供的新注册流程,未验证推荐人时只展示 Network Information、Save 和返回登录入口;查询失败在推荐人字段下显示错误,查询成功显示有效提示,再展开基础信息、商品及后续表单。Country 显示继承说明并禁用修改。会员报单模式继续按账户初始化国家、直接展示原表单,不套用游客推荐人验证门槛。
handleSelectionChange / handleInputNumber,不重新计算金额。countryId、languageId、空商品数组等,保持 Vue 2 响应式初始化正常。form.email,金额和币种来自当前订单。vue-paystack 的 V1 路径不能恢复当前服务端交易,新页通过局部继承组件使用 V2;不修改依赖或旧会员页面。组件原生按钮隐藏,由 Element 按钮调用 payWithPaystack()。上述适配仅发生在新注册页,不回写旧实现。
| 项目 | 已确认事实 / 待确认 |
|---|---|
| 匿名接口 | 已接入、待联调:游客专用 GET / POST 和推荐人接口已由前端调用;服务端匿名授权、草稿有效期与异常响应仍需在授权环境验证 |
| 支付完成 | 已确认(2026-10-28):匹配回调后立即返回登录页并保留原查询参数;前端没有服务端确认查询或独立完成页,不能把 SDK 回调当成最终付款凭证 |
| 配送参数 | 已确认:旧页提交参数没有 way 字段;本轮保持同一 payload。UI 切换仍改变地址禁用状态,没有擅自增加接口字段 |
| 密码初始值 | 已确认:当前仍有预设登录 / 支付密码;当前控件未配置 type="password" 或 show-password。清空默认值、调整控件及新增校验均未在本次文档任务中实施 |
| 计价 | 已确认:显示销售价与市场价,实际汇总和提交前余额校验仍按市场价计算;是否调整价格规则不属于本轮 UI 改造 |
| 支付环境 | 待确认:真实 accessCode、SDK、后端订单确认与扣款;本次未进行真实支付 |
| 支付方式响应 | 待确认:页面仍展示后端支付方式,但当前提交响应统一要求 accessCode / reference;其他方式能否返回同样契约需联调 |
| 缺少配置 | 已确认:国家 / 语言是固定选项,等级、地区、银行、商品和支付方式仍来自接口;商品空列表显示空状态 |
以下结果来自最初迁移阶段,当时仍使用会员报单接口、删除订单和倒计时。它们不证明当前游客接口与 V2 支付已通过同样验证;历史命令中的旧目录也不再是当前文件位置。
.eslintignore 的 public 会误匹配新目录,因此显式使用 --no-ignore。signup.spec.js:5 项通过,涵盖计价、原有守卫、提交字段 / Paystack 订单映射、取消失败及计时器释放。isDec 使用等价的显式转换。vue/compiler-sfc 编译三个新模板通过;生产构建使用当前工具链输出到临时目录,退出码 0,保留原资源体积和浏览器数据库过期提示。.env 和 package-lock.json,与此前基线一致。Windows CRLF 下按 cr-at-eol 执行差异空白检查通过,没有改写 Git 配置或其他文件的换行。真实后端联调和真实支付没有验证,不能据此声称匿名注册业务已上线。
此前文档更新对照注册页、私有业务模块、支付组件、API 封装和两份回归测试更新说明,检查了相对链接与文件范围;该轮未运行 Jest、lint、构建、浏览器或后端请求,不能将测试文件存在当作测试通过。后续邀请链接功能的实现与验证另见第 9 节;真实订单确认与支付仍需授权环境验证。
ref 的一次性默认填充、两项可编辑 / 必填标记,以及创建订单前的空值 / 纯空格拦截;接口路径和 payload 字段未改变。signup.spec.js 与 guestPaystack.spec.js 共 40 项测试通过,覆盖有效 / 空 / 重复 ref、手动修改、两项缺失和空白拦截、最终推荐人参数提交及原支付回归。onSubmit 中检测到旧 accessCode 就直接打开弹窗的分支。页面的 Continue Payment 每次都经过原表单校验,再调用 createGuestDec;弹窗内的 Continue to Paystack 仍负责打开当前交易的收银台,商品展示组件不承载提交逻辑。response.data.countryId。仅匹配固定 Nigeria / UAE ID,不根据 NG、AE 等会员编号前缀推断;缺失或不支持的国家不会初始化草稿。证据目录:C:/Users/Administrator/AppData/Local/Temp/ng-registration-country-20261029-160354,包含基线与最终测试 JSON、构建日志、浏览器结果及状态截图。
交付前对照任务开始时的 510 个项目文件哈希:仅 8 个本轮相关已有文件修改,新增 1 个国家绑定测试,无删除;另有 .idea/workspace.xml 的并发变化,本轮未写入或回滚。接口、Store、旧页面、全局样式、环境和依赖文件保持。未提交、推送或发布。