 lixi
|
4b2550f88c
|
feat(creation): 新增 patbond-creation 模块骨架——端点、租约队列 Worker、provider 适配层（T4-02）
CI / backend-test (push) Successful in 5m43s
M4 新模块，:8085，前缀 /api/v1/creation/**（ADR-023 §2，E3 拍板方案 A）。
它编排生成任务但不调用 AI 服务商——上游调用在独立的 patbond-ai（Python）
仓库，经 REST 到达。
落地内容：
- 客户端端点 4 个（创建/查询/列表/取消）+ 目录端点。创建强制 Idempotency-Key
（ADR-019：生成在上游要花钱，重试绝不能变成第二个计费任务）
- 租约队列仓储：FOR UPDATE SKIP LOCKED 领取 + 租约续期 + 回收器。目标模型
只给了索引没给回收器代码，这里补上
- Worker 三条独立调度通道（提交/轮询/回收），任一卡住不饿死其余两条。
轮询与续租在同一语句内完成——分开做会让长任务在跑时租约过期被抢，
那正是重复扣费的经典路径
- provider 适配层接口按「两阶段 submit/poll」定形 + 两个实现位
- 服务身份 JWT 签发器（独立密钥对）
- common 增 3 个错误码（40407/40408/42206）；配额与限流的两个 429 码随
配额工单落地，此处不加死枚举
关键实现纪律（注释中已逐条说明原因）：
- provider_request_id 在上游产生任何计费动作之前落库。顺序反过来，每次
超时都会变成重复扣费
- 租约回收时刻意不清 provider_request_id：保留它，下次尝试才知道「已提交过，
该轮询而非重发」
- provider 按 provider_code_snapshot 而非当前目录解析，故目录改指向后
在途任务仍由原适配器轮询
- Worker 各 pass 捕获异常：Spring 会取消抛异常的 fixedDelay 任务，
不捕获等于一次偶发失败静默停掉整个队列
刻意未实现且会响亮失败（不装作能用）：provider 两个实现位（待服务商文档
确认幂等键支持、查询接口与频率限制、单任务最长时长、产物返回形式、
限流与配额响应形态五项）、预签名上传目标获取、产物入 media.assets
（后两者取决于挂起中的对象存储决策，ADR-023 §7）。
共享物按 ADR-023 §2 复制 3 件（JWT 校验栈、UuidV7、RequestHashes）；
**存储适配层不复制**——presignPut 已存在，产物走预签名上传由 patbond-user
签发，故无需第 4 份存储层，也使 patbond-ai 零对象存储凭证。
测试：新增 GenerationJobQueueIntegrationTest 11 项，全部针对「写错了也
能跑、只在生产表现为丢任务或重复扣费」的语义：SKIP LOCKED 不把同一行
交给两个 worker、轮询确实续了它依赖的租约、回收器保留 provider_request_id、
first_attempt_at 跨重排队存活、write-once 保护、取消被状态守卫。
全量 393 → 404，零失败零跳过。
过程中被测试抓出两个真问题：UPDATE...FROM 的 RETURNING 列表未限定别名
导致 id 歧义（列表已改为单一来源派生两种形式，避免漂移）；以及夹具伪造
了物理上不可能的历史（租约过期但 started_at 是当下），被
ck_generation_jobs_lease 正确拒绝。
Readme.md 全文改中文并补齐 M2 之后的内容：原文停在 M2（pet 骨架阶段）、
完全没有 patbond-community、配置表缺 M2 之后全部条目。现覆盖六模块、
迁移链归属说明、两对密钥的区别与原因、以及各服务端点。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
2026-09-18 17:36:52 +08:00 |
|
|
lixi
|
10a43f876c
|
feat: media 域最小闭环——存储适配层 + MinIO 预签名两步上传（ADR-016/017，T3-03）
- ObjectStorage 适配层（供应商唯一缝）+ S3ObjectStorage（AWS SDK v2，
path-style，内网/公网双端点分离签发）；endpoint 未配置时服务可启动、
media 端点 500（沿 JWT 公钥先例）
- POST /api/v1/media/uploads：白名单校验（purpose/mime/byteSize 全配置项）
→ uploading 行（objectKey 服务端生成不含用户输入）→ 预签名 PUT 凭据
（requiredHeaders 定型仅 Content-Type，TTL 10m）
- complete：HEAD 校验存在性/大小/类型 → uploading→ready（guarded UPDATE
并发幂等）；对象缺失保持 uploading 可重试，内容不符置 failed 终态；
防枚举 40405；新错误码 40405/42205
- 读取侧预签名 GET（TTL 1h），桶保持私有
- compose 纳入 minio 第六容器（镜像与 Testcontainer 同 tag，桶初始化走
应用启动 ensureBucket，三环境零分叉）；init-secrets.sh 幂等追加 MinIO
根凭证到 .env（凭证零入库，ADR-021）
- MediaUploadIntegrationTest 12 例：MinIO Testcontainer 全链路直传取回 +
六类失败路径 + 库层约束一致性；uploading 超时清理只记方案（报告 13 §6）
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-09-08 17:11:44 +08:00 |
|
|
lixi
|
3c671fcaf5
|
feat: 新建 patbond-community 模块骨架（ADR-017，T3-02）
CI / backend-test (push) Successful in 7m15s
社区服务 :8084 挂入父 pom 与 compose（第五容器，依赖 postgres 健康 + user
先起保证 V5 已执行）；/api/v1/** 自骨架起接 RS256 资源侧校验（无 token/畸形/
错签/过期均 401+40101，user/pet 同款复制，P9 下沉待拍板）；GET /health 探活
在 /api/v1 之外；.sample 配置模式；生产 classpath 无 Flyway，测试经 user jar
跑全链 V1..V5（pet 先例）。模块只读写 community schema。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-09-08 16:16:26 +08:00 |
|
|
lixi
|
0eae1c9bec
|
feat: 新建 patbond-pet 模块骨架（ADR-009，T2-02 前置）
- 新 Maven 模块挂入父 pom，依赖/插件管理对齐既有 user/auth 模式
（common 依赖、starter-web/validation/jdbc、exec classifier repackage）
- 骨架内容：PetApplication、/health 探活端点（含 DB 连通检查）、
GlobalExceptionHandler（同一 {code,message,data} 信封契约）
- 与 user 共库只读写 pet_health schema；不携带 Flyway——单一迁移链
（V1..V4）仍由 patbond-user 启动时统一执行，flyway_schema_history 不拆
- 配置走 .sample 模式（默认端口 8083，敏感信息经环境变量注入不入库）
- compose 编排纳入 pet 服务（依赖 postgres 健康 + user 先起保证迁移就绪）；
Dockerfile 与既有服务同模式；Readme 模块清单同步
- 测试：Testcontainers postgres:18 上下文启动冒烟 + /health 探活断言
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-09-07 14:34:52 +08:00 |
|
|
lixi
|
c7ddaecb76
|
重构底层框架
|
2026-09-03 17:59:56 +08:00 |
|
 nmbh1122@126.com
|
5a52b44d46
|
chore: move local configs to sample files
|
2026-07-20 16:22:54 +08:00 |
|
|
nmbh1122@126.com
|
b1252b991d
|
Initialize patbond microservice modules
|
2026-07-13 09:41:15 +08:00 |
|