Files
client-web/src/modules/auth/AGENTS.md
T
ouyangxq 1e26ddad4b docs(client): add module-level AGENTS indexes for all 11 modules
新增 11 个模块级 AGENTS.md,覆盖企业工作台全部业务模块,入口表统一指向模块指引。

- 统一四段式:路径基准 / 页面与入口表 / 关键边界 / 验证入口
- 补明“页面 -> store -> API”的调用链路,避免只给目录
- 仅索引文档,未改动业务代码
2026-10-20 12:42:07 +08:00

1.8 KiB
Raw Blame History

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。