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:
@@ -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:
|
||||
|
||||
Reference in New Issue
Block a user