feat(api): password change endpoint and source device id on uploads

P3 Task 3 契约增补批次(单一事实来源 openapi.yaml + cn 实现 + e2e):

- POST /v1/auth/password-change(operationId changePassword,需求 4.1 的
  P1 契约缺口补齐):Bearer + {oldPassword 1-128, newPassword 8-128} → 204;
  旧密码错误 401 AUTH_INVALID_CREDENTIALS;成功后事务内更新 argon2 哈希、
  撤销该用户除当前会话外的全部其他会话(当前会话保留,本人不下线)、写
  审计 auth.password_change。
- sourceDeviceId(A19 设备来源语义):UploadInitRequest 可选 8-64 位设备
  标识;upload_sessions 落列(VARCHAR(64) utf8mb4_0900_bin,可空,存量
  行 NULL 兼容);GET /uploads 条目回显;幂等重放不比对(first-writer,
  首次落库值不随重放漂移)。
- e2e:auth 增 4 例(未认证 401 / 新密码过短 400 / 旧密码错误 401 且会话
  无副作用 / 成功后他端会话撤销当前保留 + 新旧密码登录裁决 + 审计);
  uploads 增 1 例(携带落库回显、换设备重放保留首值、缺省 null、长度
  越界 400)。api e2e 179 → 184;contracts gen/redocly/单测、worker、
  sync 门全绿。

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-19 00:59:39 +08:00
parent f975321b67
commit 31ba03de11
11 changed files with 437 additions and 29 deletions
+11 -3
View File
@@ -1,10 +1,10 @@
// services/api/src/uploads/dto.ts —— 上传端点入参 DTO(Task 18)。校验约束对齐
// 契约 UploadInitRequest:
// services/api/src/uploads/dto.ts —— 上传端点入参 DTO(Task 18;sourceDeviceId
// 为 P3 Task 3 契约增补)。校验约束对齐契约 UploadInitRequest:
// · contentType 限白名单枚举(image/heic 暂定,G2 真机验证);
// · bytes ≥ 1(契约 minimum);上限 UPLOAD_MAX_BYTES 是环境相关量,逐请求
// 惰性读取,故在服务层校验(同 filename 扩展名白名单与 categoryId 属主校验);
// · clientTaskId/filename/albumId/categoryId 列宽对齐 db-cn schema
// (VarChar 128/255/64/64)。
// (VarChar 128/255/64/64);sourceDeviceId 8-64(A19 设备来源语义)。
import {
IsIn,
IsInt,
@@ -13,6 +13,7 @@ import {
IsString,
MaxLength,
Min,
MinLength,
} from 'class-validator';
import { UPLOAD_CONTENT_TYPES, type UploadContentType } from './support';
@@ -47,4 +48,11 @@ export class UploadInitRequestDto {
@IsIn(UPLOAD_CONTENT_TYPES)
contentType!: UploadContentType;
/** 客户端设备标识(A19,P3 Task 3 增补):可选,8-64 字符。 */
@IsOptional()
@IsString()
@MinLength(8)
@MaxLength(64)
sourceDeviceId?: string;
}
@@ -180,6 +180,8 @@ export class UploadsService {
objectKey: stagingObjectKey(uploadId, photoId, ext),
expectedBytes: dto.bytes,
contentType: dto.contentType,
// A19 设备来源(P3 Task 3):未携带落 null;幂等重放不比对(首值保留)。
sourceDeviceId: dto.sourceDeviceId ?? null,
expiresAt: new Date(Date.now() + signedUrlTtlSeconds() * 1000),
},
});
@@ -226,6 +228,8 @@ export class UploadsService {
* 幂等参数一致性:对「会话行可持久化的事实」逐项比对——albumId/expectedBytes/
* contentType,外加 staging 键扩展名 vs 新 filename 扩展名(filename 本身不落库,
* schema 无该列;同扩展名改名视为同一任务意图,返回原会话)。
* sourceDeviceId(P3 Task 3)刻意不比对:幂等重放换设备时保留首次落库值
* (first-writer)——任务归属以创建时刻的设备为准,历史不随重放漂移。
*/
private paramsMatch(
session: SessionRow,
@@ -499,6 +503,7 @@ export class UploadsService {
expectedBytes: row.expectedBytes,
contentType: row.contentType,
createdAt: row.createdAt.toISOString(),
sourceDeviceId: row.sourceDeviceId,
photo: {
photoId: row.photoId,
processingState: