2026-09-21 19:28:22 +08:00
|
|
|
|
# for-test
|
|
|
|
|
|
|
2026-09-23 02:30:28 +08:00
|
|
|
|
当看到这句话时,说明代码下载成功了
|
|
|
|
|
|
|
2026-10-17 23:22:10 +08:00
|
|
|
|
## 商户端登录/注册 Demo
|
|
|
|
|
|
|
|
|
|
|
|
基于 PRD《【登陆/注册】》(飞书 Wiki)实现的可运行 Demo。
|
|
|
|
|
|
|
|
|
|
|
|
### 目录结构
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
prototype/ # 可交互 HTML 原型(纯静态,内置 Mock,双击即用)
|
|
|
|
|
|
frontend/ # 正式前端(原生 HTML/CSS/JS,调用后端 API)
|
|
|
|
|
|
backend/ # 后端服务(Node.js 原生 http,零依赖)
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 快速启动
|
|
|
|
|
|
|
|
|
|
|
|
1. 启动后端(端口 3000):
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
cd backend
|
|
|
|
|
|
node server.js
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
预置演示账号:`demo001` / `Demo@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 | 忘记密码 |
|