refactor(auth): API层目录化拆分（189行→9个单职责文件） #1176

Merged

auto-approve-bot merged 11 commits from refactor/auth-api-directory into develop 2026-07-30 01:29:23 +08:00

Conversation 5 Commits 11 Files Changed 11

+266 -189

xiaoxia commented 2026-07-30 00:28:23 +08:00

Owner

Copy Link

Copy Source

改动说明

将 api/auth.ts（189行，12个API函数+10个类型）按功能模块拆分为目录结构：

• auth/types.ts - 所有类型定义
• auth/user.ts - normalizeUser 工具函数
• auth/login.ts - 登录/注册/登出/刷新token
• auth/currentUser.ts - 获取当前用户
• auth/password.ts - 密码重置
• auth/email.ts - 邮箱验证
• auth/wechat.ts - 微信登录
• auth/contact.ts - 发送验证码/绑定联系方式
• auth/index.ts - re-export 保持向后兼容

路径不变：@/api/auth 仍然有效，所有导出均保持原名。

改动行数

• 原文件：189行（单文件）
• 拆分后：9个文件，单文件最大82行（types.ts）
• 主入口 index.ts：39行

风险

• 纯结构重构，无逻辑改动
• index.ts re-export 所有导出，路径向后兼容

## 改动说明 将 `api/auth.ts`（189行，12个API函数+10个类型）按功能模块拆分为目录结构： - `auth/types.ts` - 所有类型定义 - `auth/user.ts` - normalizeUser 工具函数 - `auth/login.ts` - 登录/注册/登出/刷新token - `auth/currentUser.ts` - 获取当前用户 - `auth/password.ts` - 密码重置 - `auth/email.ts` - 邮箱验证 - `auth/wechat.ts` - 微信登录 - `auth/contact.ts` - 发送验证码/绑定联系方式 - `auth/index.ts` - re-export 保持向后兼容 **路径不变**：`@/api/auth` 仍然有效，所有导出均保持原名。 ## 改动行数 - 原文件：189行（单文件） - 拆分后：9个文件，单文件最大82行（types.ts） - 主入口 index.ts：39行 ## 风险 - 纯结构重构，无逻辑改动 - index.ts re-export 所有导出，路径向后兼容

xiaoxia added 10 commits 2026-07-30 00:28:23 +08:00

refactor(auth): split types.ts from auth.ts 57720f5787

refactor(auth): split user.ts from auth.ts f68eb996d2

refactor(auth): split login.ts from auth.ts 070cc72719

refactor(auth): split currentUser.ts from auth.ts 70200220bf

refactor(auth): split password.ts from auth.ts 0ef6b0a4a3

refactor(auth): split email.ts from auth.ts 0b88552fb9

refactor(auth): split wechat.ts from auth.ts 5033185fb3

refactor(auth): split contact.ts from auth.ts 4b4df21b5c

refactor(auth): split index.ts from auth.ts 404d15fe02

refactor(auth): remove old auth.ts (moved to auth/ directory) 08bf93d6ad

gitea-actions bot commented 2026-07-30 00:30:31 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1176
预览链接	https://pr-1176.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1176 | | 预览链接 | [https://pr-1176.preview.xiaoxiajianji.com](https://pr-1176.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

auto-approve-bot approved these changes 2026-07-30 00:31:46 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-07-30 00:31:46 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

xiaoxia added 1 commit 2026-07-30 00:55:08 +08:00

test(auth): 更新测试文件头注释，适配auth目录化 f50e90c8c4

auto-approve-bot commented 2026-07-30 00:58:04 +08:00

Collaborator

Copy Link

Copy Source

代码审查结果 - PR #1176

⚠️ 问题（0个需要修改）

无

💡 建议（0个可选）

无

---

✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能无问题

【阻塞级判定】

• 是否存在阻塞级问题：否
• 阻塞级问题数量：0 个

📊 审查概览

• 整体评价：通过
• 建议级问题数量：0 个

🔴 阻塞级问题（必须修复）

无

💡 改进建议（不阻塞合并）

无

✅ 良好实践

1. 模块化拆分：将原本臃肿的单文件 auth.ts 按功能拆分为 login, password, wechat, types 等模块，提高了代码的可维护性和可读性。
2. 向后兼容：通过 index.ts 统一导出所有类型和函数，确保了引入路径 @/api/auth 的向后兼容性，降低了重构对其他代码的影响。
3. 关注点分离：将类型定义 (types.ts) 和工具函数 (user.ts) 独立出来，结构清晰，符合单一职责原则。
4. 逻辑一致性：重构过程中完整保留了原有的业务逻辑（如 normalizeUser 的处理逻辑、refreshAccessToken 使用裸 axios 的特殊处理），未引入逻辑变更。

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-07-29 16:58:04 | 模型:}

## 代码审查结果 - PR #1176 ### ⚠️ 问题（0个需要修改） 无 ### 💡 建议（0个可选） 无 --- ✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能无问题 ### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：0 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 无 ### ✅ 良好实践 1. **模块化拆分**：将原本臃肿的单文件 `auth.ts` 按功能拆分为 `login`, `password`, `wechat`, `types` 等模块，提高了代码的可维护性和可读性。 2. **向后兼容**：通过 `index.ts` 统一导出所有类型和函数，确保了引入路径 `@/api/auth` 的向后兼容性，降低了重构对其他代码的影响。 3. **关注点分离**：将类型定义 (`types.ts`) 和工具函数 (`user.ts`) 独立出来，结构清晰，符合单一职责原则。 4. **逻辑一致性**：重构过程中完整保留了原有的业务逻辑（如 `normalizeUser` 的处理逻辑、`refreshAccessToken` 使用裸 axios 的特殊处理），未引入逻辑变更。 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-07-29 16:58:04 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

auto-approve-bot merged commit 5256bd0d8b into develop 2026-07-30 01:29:23 +08:00

auto-approve-bot deleted branch refactor/auth-api-directory 2026-07-30 01:29:23 +08:00

gitea-actions bot commented 2026-07-30 01:30:01 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1176 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1176 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1176