feat(auth): 新增微信同步登录接口 wechat-sync（小程序BFF用） #185

Merged

xiaoxia merged 27 commits from feat/wechat-sync-login into develop 2026-07-07 00:37:07 +08:00

Conversation 0 Commits 27 Files Changed 6

+335 -2

xiaoxia commented 2026-07-06 22:10:51 +08:00

Owner

Copy Link

Copy Source

功能说明

新增系统级内部接口 POST /api/v1/auth/wechat-sync，供小程序BFF层调用，实现微信 openid → 查找/创建SaaS用户 → 返回 token 的完整链路。

改动清单

领域层 (Domain)

• packages/domain/entities.py：User 实体新增 wechat_openid、wechat_unionid 字段

端口层 (Ports)

• packages/ports/user_repository.py：新增 find_by_wechat_openid()、find_by_wechat_unionid() 抽象方法

适配器层 (Adapters)

• packages/adapters/sqlalchemy_impl/user_repository.py：实现微信openid/unionid查询方法，save和_to_entity同步映射

应用层 (Application)

• packages/application/auth/wechat_sync_use_case.py（新增）：微信同步登录用例
  • openid匹配 → unionid匹配 → 自动创建新用户
  • 返回 access_token + refresh_token + 用户信息 + is_new_user标记

路由层 (API Routes)

• apps/api/app/api/routes/auth.py：新增 /wechat-sync 路由
  • X-API-Key 系统级鉴权（INTERNAL_API_KEYS 环境变量配置）
  • include_in_schema=False 不对外暴露

数据库

• alembic 迁移 025_add_user_wechat_fields 已在 develop 分支上

安全设计

• 接口不直接暴露给终端用户，仅BFF层通过内部API Key调用
• API Key支持环境变量配置和文件持久化两种方式
• 生产环境未配置Key时直接拒绝

关联项目

小虾智剪微信小程序（miniapp）BFF层依赖此接口

## 功能说明 新增系统级内部接口 `POST /api/v1/auth/wechat-sync`，供小程序BFF层调用，实现微信 openid → 查找/创建SaaS用户 → 返回 token 的完整链路。 ## 改动清单 ### 领域层 (Domain) - `packages/domain/entities.py`：User 实体新增 `wechat_openid`、`wechat_unionid` 字段 ### 端口层 (Ports) - `packages/ports/user_repository.py`：新增 `find_by_wechat_openid()`、`find_by_wechat_unionid()` 抽象方法 ### 适配器层 (Adapters) - `packages/adapters/sqlalchemy_impl/user_repository.py`：实现微信openid/unionid查询方法，save和_to_entity同步映射 ### 应用层 (Application) - `packages/application/auth/wechat_sync_use_case.py`（新增）：微信同步登录用例 - openid匹配 → unionid匹配 → 自动创建新用户 - 返回 access_token + refresh_token + 用户信息 + is_new_user标记 ### 路由层 (API Routes) - `apps/api/app/api/routes/auth.py`：新增 `/wechat-sync` 路由 - X-API-Key 系统级鉴权（INTERNAL_API_KEYS 环境变量配置） - include_in_schema=False 不对外暴露 ### 数据库 - alembic 迁移 `025_add_user_wechat_fields` 已在 develop 分支上 ## 安全设计 - 接口不直接暴露给终端用户，仅BFF层通过内部API Key调用 - API Key支持环境变量配置和文件持久化两种方式 - 生产环境未配置Key时直接拒绝 ## 关联项目 小虾智剪微信小程序（miniapp）BFF层依赖此接口

xiaoxia self-assigned this 2026-07-06 22:10:51 +08:00

xiaoxia added 27 commits 2026-07-06 22:10:51 +08:00

Merge pull request 'Merge develop → main: 阶段0-3 全量上线（V21 UI + Phase 8 + CosyVoice）' (#176) from develop into main 8b2ba8dc16

fix(api): add response_class=Response to DELETE endpoint for 204 status bb21990173

fix(api): move Response import to correct position after other imports 87a5ce84d3

hotfix: 移除 delete 路由的 response_class=Response 修复 204 断言崩溃 ... dd2808d17a

FastAPI 不允许 status_code=204 同时指定 response_class=Response，
导致 API 容器启动时 AssertionError 不断重启。

修复 8 处 @router.delete 装饰器：
- duplication.py:242
- recipes.py:177
- templates.py:198, 276
- titles.py:146
- tts.py:179
- voice_clones.py:194
- voices.py:319

Merge pull request 'hotfix: 修复 204 状态码 response_class=Response 导致 API 容器崩溃' (#177) from hotfix/fix-204-response-class into main d0e4235828

fix: correct 204 response in edit_plans delete endpoint ... 167ee9a9d7

Remove response_class=Response, change return type to Response, add explicit return Response(status_code=204)

fix: correct 204 response in edit_templates delete endpoint ... 4d1a0925d3

Change return type to Response, add explicit return Response(status_code=204)

Merge pull request 'Merge develop into main (v0.1.105: Worker healthcheck fix)' (#178) from develop into main f15e049f37

Merge pull request 'Release: 安全修复 + 代码优化 + Mock替换 (2026-07-03)' (#181) from develop into main 8858a137b1

Merge pull request 'Release: 补齐 timeline API (P2收尾) (2026-07-03)' (#182) from develop into main 54c88e58a3

Merge pull request 'fix(infra): Worker healthcheck YAML 修复 + APP_VERSION 默认值' (#183) from develop into main faec1791ad

Merge pull request 'Merge develop: nginx proxy_pass 永久修复' (#184) from develop into main 0d07febb78

Merge develop → main: Phase 1-3 全量上线 + workspace清理（v0.1.109） c126daeda5

Merge branch 'develop' c4e7d9a6f9

Merge branch 'develop' dd2db817bc

Merge branch 'develop' - v0.1.113: 安全审计修复(P1越权) + UI打磨三批 + 测试污染修复 a6e809600e

Merge branch 'develop' - v0.1.114: 修复API容器启动失败(worker模块导入问题) dd1a83ec51

Merge branch 'develop' - v0.1.115: V21一键生成页面 + 测试修复 ea40b41c05

Merge branch 'develop' - v0.1.116: API/Worker依赖拆分，API镜像瘦身 f06c7f9d33

Merge branch 'develop' - v0.1.117: 补025号迁移文件 6a7fde9d90

Merge branch 'develop' - v0.1.118: TTS失败返回格式统一 + StrEnum反序列化修复 8e60c412f7

Merge develop into main - v0.1.119: V21 UI全局改造 + CI门禁 + E2E修复 + 暗色模式修复 d8770ba57f

Merge develop into main - v0.1.120 8a386f6172

feat(auth): 仓储接口新增find_by_wechat_openid/unionid方法 b3118b05ab

feat(auth): SQLAlchemy仓储实现微信openid/unionid查询 f94ffa77bf

feat(auth): User实体新增wechat_openid/wechat_unionid字段 a568c97439

feat(auth): 新增微信同步登录接口wechat-sync（内部系统级接口，支持openid查找/创建用户并返回SaaS token） 46d98f369d

xiaoxia merged commit ed6150fa52 into develop 2026-07-07 00:37:07 +08:00

xiaoxia referenced this issue from a commit 2026-07-07 00:37:07 +08:00

Merge pull request 'feat(auth): 新增微信同步登录接口 wechat-sync（小程序BFF用）' (#185) from feat/wechat-sync-login into develop

xiaoxia referenced this issue from a commit 2026-07-07 00:49:18 +08:00

fix(ci): 修复 PR #185 微信同步登录 Validate 失败

Sign in to join this conversation.

Reviewers

No Reviewers

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 xiaoxia

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#185