photo-live

xinyouhe/photo-live

Fork 0

Commit Graph

Author	SHA1	Message	Date
浅念	4937eeecff	feat(api): usage summary with threshold alerts P4a Task 5（A23 后台侧）：用量统计与阈值告警后端全链。 - cn 迁移（校对手决 utf8mb4_0900_bin）：usage_thresholds 单行配置表（迁移内种子行，storageBytes/perAlbumBytes BigInt?，null=维度停用）+ usage_alerts 告警账本（kind storage\|perAlbum、albumId?、resolvedAt? 索引）。「同 kind+albumId 活跃告警唯一」为应用级约束（MySQL 无部分唯一索引）：评估事务以单行配置 FOR UPDATE 作串行化锚点闭合竞态。 - 共享核心 packages/db-cn/src/usage.ts：computeUsageAggregates（非 deleted 口径实时 SUM：photos groupBy + 变体 JOIN raw）+ evaluateUsage （storage/perAlbum 两维超阈 ensure、回落/停用 resolve、去重）+ evaluateUsageSafe（自开事务、失败仅记日志不拖垮业务主流程）。api 与 worker 共用（放置原因见文件头）。 - api：GET /admin/usage/summary（相册聚合 + totals + 阈值 + 告警：活跃在前、近期解除补位，合计 100）与 PUT /admin/usage/thresholds（缺省保持/显式 null 清除 + 契约「即刻重新评估」）；仅 admin。BigInt 运输决策：库内 BIGINT、JSON 出入口 Number() 收敛（2^53≈9PB 上限，DTO 以 MAX_SAFE_INTEGER 拒绝超界输入杜绝静默失真）。 - 检查点（提交后评估）：worker 发布事务后（仅真实 published）、worker 水印任务完成后、api photos 可见性迁移（PATCH/软删除）与批量隐藏后、阈值 PUT 后。 - tests：usage e2e +6（汇总数学/降序/标题、403/401、400 校验矩阵、 perAlbum 告警产生-去重-上调解除、storage 告警-null 清除解除、hidden 计入+deleted 回落且穿过 api 检查点）；两侧 reset 增补 usage 表截断 + 单行重种。全量回归：api e2e 214/214、api 单测 51/51、worker 单测 14/14 + e2e 13/13。 Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-09-20 19:01:41 +08:00
浅念	243b2f8721	feat(worker): watermark versioning with atomic history regeneration Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-09-20 17:53:44 +08:00
浅念	64a2cec788	feat(worker): sharp pipeline with orientation, variants, exif strip Task 20: services/worker package (@photo/worker, commonjs) with jest unit/e2e configs mirroring api conventions (root .env via test/load-env.ts, moduleNameMapper to @photo/contracts/db-cn/storage TS sources, maxWorkers 1, test/reset.ts = MySQL TRUNCATE + MinIO photo-live/dev prefix wipe) and the sharp processing pipeline runPipeline(): metadata whitelist gate (jpeg/png/webp/avif/heif/tiff, else PipelineError UNSUPPORTED_TYPE), decode failures mapped to PipelineError DECODE_FAILED, no-arg .rotate() auto-orientation (EXIF 5-8 swaps stored width/height), thumb <=480w q75 and browse <=1920 q82 JPEG variants with withoutEnlargement, and no withMetadata so outputs carry no EXIF/GPS at all. sharp 0.35 prebuilt loads script-free under pnpm 10; its win32 libvips lacks a HEVC encoder, so the HEVC-HEIF unit case self-skips with a console note (G2 verifies with real iPhone samples) while the AV1-HEIF case covers the same libheif decode path / 'heif' format bucket. Co-Authored-By: Claude Code <noreply@anthropic.com>	2026-09-17 23:16:20 +08:00

Author

SHA1

Message

Date

浅念

4937eeecff

feat(api): usage summary with threshold alerts

P4a Task 5（A23 后台侧）：用量统计与阈值告警后端全链。

- cn 迁移（校对手决 utf8mb4_0900_bin）：usage_thresholds 单行配置表
  （迁移内种子行，storageBytes/perAlbumBytes BigInt?，null=维度停用）+
  usage_alerts 告警账本（kind storage|perAlbum、albumId?、resolvedAt?
  索引）。「同 kind+albumId 活跃告警唯一」为应用级约束（MySQL 无部分
  唯一索引）：评估事务以单行配置 FOR UPDATE 作串行化锚点闭合竞态。
- 共享核心 packages/db-cn/src/usage.ts：computeUsageAggregates（非
  deleted 口径实时 SUM：photos groupBy + 变体 JOIN raw）+ evaluateUsage
  （storage/perAlbum 两维超阈 ensure、回落/停用 resolve、去重）+
  evaluateUsageSafe（自开事务、失败仅记日志不拖垮业务主流程）。api 与
  worker 共用（放置原因见文件头）。
- api：GET /admin/usage/summary（相册聚合 + totals + 阈值 + 告警：活跃
  在前、近期解除补位，合计 100）与 PUT /admin/usage/thresholds（缺省
  保持/显式 null 清除 + 契约「即刻重新评估」）；仅 admin。BigInt 运输
  决策：库内 BIGINT、JSON 出入口 Number() 收敛（2^53≈9PB 上限，DTO 以
  MAX_SAFE_INTEGER 拒绝超界输入杜绝静默失真）。
- 检查点（提交后评估）：worker 发布事务后（仅真实 published）、worker
  水印任务完成后、api photos 可见性迁移（PATCH/软删除）与批量隐藏后、
  阈值 PUT 后。
- tests：usage e2e +6（汇总数学/降序/标题、403/401、400 校验矩阵、
  perAlbum 告警产生-去重-上调解除、storage 告警-null 清除解除、hidden
  计入+deleted 回落且穿过 api 检查点）；两侧 reset 增补 usage 表截断 +
  单行重种。全量回归：api e2e 214/214、api 单测 51/51、worker 单测
  14/14 + e2e 13/13。

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-09-20 19:01:41 +08:00

浅念

243b2f8721

feat(worker): watermark versioning with atomic history regeneration

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-09-20 17:53:44 +08:00

浅念

64a2cec788

feat(worker): sharp pipeline with orientation, variants, exif strip

Task 20: services/worker package (@photo/worker, commonjs) with jest
unit/e2e configs mirroring api conventions (root .env via test/load-env.ts,
moduleNameMapper to @photo/contracts/db-cn/storage TS sources, maxWorkers 1,
test/reset.ts = MySQL TRUNCATE + MinIO photo-live/dev prefix wipe) and the
sharp processing pipeline runPipeline(): metadata whitelist gate
(jpeg/png/webp/avif/heif/tiff, else PipelineError UNSUPPORTED_TYPE),
decode failures mapped to PipelineError DECODE_FAILED, no-arg .rotate()
auto-orientation (EXIF 5-8 swaps stored width/height), thumb <=480w q75
and browse <=1920 q82 JPEG variants with withoutEnlargement, and no
withMetadata so outputs carry no EXIF/GPS at all. sharp 0.35 prebuilt
loads script-free under pnpm 10; its win32 libvips lacks a HEVC encoder,
so the HEVC-HEIF unit case self-skips with a console note (G2 verifies
with real iPhone samples) while the AV1-HEIF case covers the same
libheif decode path / 'heif' format bucket.

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-09-17 23:16:20 +08:00

3 Commits