rain
73 lines
3.4 KiB
Markdown
73 lines
3.4 KiB
Markdown
# TAC Layui 实际挂载点修复实施计划
|
||
|
||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||
|
||
**目标：** 修复 Layui 遮罩已显示、验证码接口已返回 200，但 TAC 验证窗口仍不显示的问题。
|
||
|
||
**架构：** `CaptchaPages.createCaptchaLayer` 使用 Layui `layer.open` 的字符串 `content` 创建弹层内部真实挂载节点；弹层创建完成后再从 `document` 查询该实际节点，并把它交给 `CaptchaConfig.bindEl`。这样 Layui 负责弹层，TAC 挂到已经进入页面的真实 DOM。
|
||
|
||
**技术栈：** Layui 2.11.5、TAC 原生 CSS/JS、原生 JavaScript、Node `assert` 测试。
|
||
|
||
## 全局约束
|
||
|
||
- 计划创建时间：2026-07-10 10:59:52 +08:00。
|
||
- 不修改 `public/tac/css/tac.css`、`public/tac/js/tac.min.js` 或 Layui 第三方文件。
|
||
- 不新增验证码自定义 CSS，不注入样式，不传 TAC 视觉配置。
|
||
- 保留 `auth-pages.js -> CaptchaPages.ensureToken -> TAC` 调用链，只修正弹层挂载点。
|
||
|
||
---
|
||
|
||
### 任务 1：复现“遮罩有但实际挂载点不可见”
|
||
|
||
**文件：**
|
||
- 修改：`tests/captcha-pages.test.js`
|
||
|
||
- [x] **步骤 1：写失败测试**
|
||
|
||
断言 `layer.open` 的 `content` 是包含唯一 `data-captcha-layer-box` 的字符串；`createCaptchaLayer` 必须在弹层打开后从 `document.querySelector` 取到实际挂载节点并返回。
|
||
|
||
- [x] **步骤 2：运行失败测试**
|
||
|
||
运行：`node tests\captcha-pages.test.js`
|
||
|
||
预期：失败，当前实现仍返回打开前创建的原生 DOM。
|
||
|
||
### 任务 2：修正实际挂载点
|
||
|
||
**文件：**
|
||
- 修改：`public/js/captcha-pages.js`
|
||
|
||
- [x] **步骤 1：最小实现**
|
||
|
||
增加内部自增 ID，用字符串内容创建 `<div data-captcha-layer-box="..."></div>`；`layer.open` 后查询该节点并作为 `box` 返回。
|
||
|
||
- [x] **步骤 2：运行聚焦测试**
|
||
|
||
运行：`node tests\captcha-pages.test.js; node --check public\js\captcha-pages.js`
|
||
|
||
预期：全部通过。
|
||
|
||
### 任务 3：记录和回归
|
||
|
||
**文件：**
|
||
- 修改：`docs/pc-api-page-integration-tracker-2026-07-09.md`
|
||
- 修改：`docs/superpowers/plans/2026-07-10-tac-layer-real-mount-fix.md`
|
||
|
||
- [x] **步骤 1：补充 PC-019 记录**
|
||
|
||
记录用户浏览器复现现象、根因、修正方式、验证命令。
|
||
|
||
- [x] **步骤 2：最终验证**
|
||
|
||
运行：`node tests\auth-page-structure.test.js; node tests\captcha-pages.test.js; node --check public\js\captcha-pages.js; git diff --check`
|
||
|
||
预期：全部通过；`git diff --check` 仅允许 Git 行尾提示，不允许空白错误。
|
||
|
||
## 完成记录
|
||
|
||
- 完成时间：2026-07-10 11:04:18 +08:00。
|
||
- 根因：PC-018 只让 `layer.open` 不再因 `.parents()` 报错，但仍把打开前创建的临时 DOM 返回给 TAC；真实浏览器里 Layui 遮罩已出现，`/captcha/challenge` 也返回 200，但 TAC 没有挂到可见弹层内容区。
|
||
- 修复：`layer.open` 使用字符串 `content` 创建弹层内部真实节点，随后通过 `document.querySelector('[data-captcha-layer-box="..."]')` 获取实际挂载点并交给 `CaptchaConfig.bindEl`。
|
||
- 约束：未修改 `public/tac`，未新增验证码 CSS，未传 TAC 视觉配置。
|
||
- 验证：失败测试已先复现；修复后 `node tests\captcha-pages.test.js` 和 `node --check public\js\captcha-pages.js` 通过。最终回归记录见 `docs/pc-api-page-integration-tracker-2026-07-09.md` 的 PC-019。
|