docs(media): 微调媒体说明与 OpenAPI 描述

docs/media.md

@@ -15,8 +15,8 @@
 | 时机 | 位置 | 行为 |
 |------|------|------|
 | 申请上传凭证 | `upload/logic.CreateCredential` → `checkDeclaredSize` | 按 `purpose` 校验声明 `size`；超限默认 **打 Warn 日志**，`media.user_reject=true` 时返回 `40005` |
-| 广场发帖 | `square/logic.publish` → `checkPublishMedia` | 用客户端声明的图/视频宽高与 size 校验；同上 |
-| 朋友圈发帖 | `moment/logic.publish` → `checkPublishMedia` | 同上 |
+| 广场发帖 | `square/logic.publish` → `checkMediaMeta` | 用客户端声明的图/视频宽高与 size 校验；同上 |
+| 朋友圈发帖 | `moment/logic.publish` → `checkMediaMeta` | 同上 |
 
 主压缩仍在 **App 上传前**；服务端不把用户文件再压一遍（除非开启拒收）。
 
@@ -36,6 +36,7 @@
 
 ## 部署注意
 
-- 视频压缩依赖主机 **`ffmpeg`**（`media.ffmpeg_path`，默认 `ffmpeg`）。
+- 视频压缩依赖主机 **`ffmpeg`**（`media.ffmpeg_path`，默认 `ffmpeg`）。运行镜像 `Dockerfile` 已 `apk add ffmpeg`。
 - 迁移：`migrations/0026_square_bot_rss.sql`（`source` / `source_url` / `expires_at` + `t_square_bot_links`）。
 - Seed：`go run ./cmd/seed -config configs/config.yaml` 确保 `bot001@spark.bot`… 存在。
+- 错误码：`40005` / `media_oversized`（`media.user_reject=true` 时拒凭证或发帖）。

internal/transport/http/docs/openapi.yaml

@@ -3262,8 +3262,10 @@ components:
         12 SYNC_MESSAGES 13 SYNC_MESSAGES_FINISH 14 KICK 15 DELETE_MESSAGE
     EnvelopeCode:
       type: string
-      enum: ["0", "40001", "40002", "40003", "40004", "40101", "40102", "40301", "40401", "40402", "40901", "42901", "42902", "42903", "49901", "50001", "50002", "50003", "50301", "50401"]
-      description: envelope.code。成功为 "0"
+      enum: ["0", "40001", "40002", "40003", "40004", "40005", "40101", "40102", "40103", "40301", "40401", "40402", "40901", "42901", "42902", "42903", "49901", "50001", "50002", "50003", "50301", "50401"]
+      description: |
+        envelope.code。成功为 "0"。
+        `40005` media_oversized：媒体分辨率/体积超限（开启 media.user_reject 时拒收）。
     Envelope:
       type: object
       required: [code, msg, request_id, data]