新增 11 个模块级 AGENTS.md,覆盖企业工作台全部业务模块,入口表统一指向模块指引。 - 统一四段式:路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 补明“页面 -> store -> API”的调用链路,避免只给目录 - 仅索引文档,未改动业务代码
1.8 KiB
1.8 KiB
Client 登录与注册模块指引
路径基准与读取顺序
- 本文件适用于
src/modules/auth/,代码路径相对本目录;应用公共规则见../../../AGENTS.md。 - 页面:
views/LoginView.vue、views/RegisterView.vue、views/LegalDocumentView.vue(/login、/register、/legal/*);会话状态在store/auth.ts,请求在api/auth.ts。 - 后端:登录与 Token 归
auth/,注册与资质归iam/+file/。
页面与入口
| 目标 | 页面/入口 | API 与后端 |
|---|---|---|
| 登录、记住账号 | views/LoginView.vue |
api/auth.ts、store/auth.ts;auth/ |
| 企业注册与资质上传 | views/RegisterView.vue |
api/auth.ts;iam/、file/ |
| 用户协议与隐私政策 | views/LegalDocumentView.vue、legalDocuments.ts |
静态文案 |
| 认证壳层与布局 | components/AuthShell.vue |
— |
| 令牌解析与刷新 | store/auth.ts、utils/jwt.ts |
../../api/http.ts、../../api/session.ts |
关键边界
- 页面不拼
Authorization、不自行持久化密码;Access/Refresh Token 只在store/auth.ts与src/api/session.ts编排。 - 注册时登录手机号同时初始化公司联系电话,注册完成后两者独立维护;企业资料只改
contactPhone。 - “记住账号”只保存登录 ID,不改变 Token 的持久化与续期策略。
- 注册必填资质仅营业执照与统一社会信用代码,法人身份证选填;上传成功不等于审核通过。
- 并发或跨标签页 401 共用一次刷新,每个原请求最多重放一次。
验证
- 定向:
pnpm test src/modules/auth/<目标测试>;登录或注册字段变化同时核对auth/、iam/合同。 - 本文件或索引变更后,从后端根运行
./scripts/agents-index-contract.ps1。