Files
for-test/README.md
T

66 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# for-test
当看到这句话时,说明代码下载成功了
## 商户端登录/注册 Demo
基于 PRD《【登陆/注册】》(飞书 Wiki)实现的可运行 Demo。
### 目录结构
```
prototype/ # 可交互 HTML 原型(纯静态,内置 Mock,双击即用)
frontend/ # 正式前端(原生 HTML/CSS/JS,调用后端 API)
backend/ # 后端服务(Node.js 原生 http,零依赖)
design/ # 飞书白板设计图导出
```
### 快速启动
1. 启动后端(端口 3000):
```bash
cd backend
node server.js
```
预置演示账号:`demo001` / `Gpx@2026`
(验证码登录场景,后端会在响应中回传 `devCode` 演示验证码,便于联调)
2. 启动前端:
```bash
cd frontend
python3 -m http.server 8080
# 浏览器访问 http://localhost:8080
```
前端会自动请求 `http://localhost:3000` 的后端 API(CORS 已放开)。
3. 交互原型(无需后端):直接用浏览器打开 `prototype/index.html`。
### 已实现的 PRD 规则
| 规则 | 说明 |
|---|---|
| 验证码有效期 | 10 分钟 |
| 验证码冷却 | 发送后 60s 内不允许二次触发 |
| 新码失效旧码 | 新验证码发出后旧验证码立即失效 |
| 静默注册 | 手机号/邮箱验证码校验通过后,未注册自动注册并登录 |
| 协议勾选 | 未勾选协议时,点击【获取验证码】拦截并提示 |
| 账号密码错误提示 | 「无效登录信息,请核对登录信息」 |
| IP 冻结 | 同 IP 连续错误 5 次 → 「暂停登录权限,请联系客服」,24h 后解冻 |
| 忘记密码 | 发送重置邮件(演示实现:日志) |
| 子账号格式 | 子ID@主ID(如 `zhangsan@demo001`) |
| 多语言 | zh-CN(默认)/ zh-TW / en,右上角切换,无刷新生效 |
| 微信扫码登录 | MVP 首期暂不支持,界面与接口已预留 |
### API 一览
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/captcha/send | 发送验证码 `{type: phone\|email, target}` |
| POST | /api/login/verify-code | 验证码登录(含静默注册) |
| POST | /api/login/password | 账号密码登录(含 IP 冻结控制) |
| POST | /api/password/forgot | 忘记密码 |