From 958de5ef2247919a08b345e41d6498b5cd26b913 Mon Sep 17 00:00:00 2001
From: jianghaifeng <haifeng_hello@163.com>
Date: Fri, 30 Oct 2026 17:14:46 +0800
Subject: [PATCH] =?UTF-8?q?feat(config):=20/app/config=20=E4=B8=8B?=
 =?UTF-8?q?=E5=8F=91=E7=99=BB=E5=BD=95=E9=A1=B5=E8=83=8C=E6=99=AF=E5=9C=B0?=
 =?UTF-8?q?=E5=9D=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/api-phase1.md                                              | 1 +
 .../main/java/com/fruitshorts/app/service/AppConfigService.java | 1 +
 .../app/controller/AppCreatorAndConfigContractTest.java         | 2 ++
 3 files changed, 4 insertions(+)

diff --git a/docs/api-phase1.md b/docs/api-phase1.md
index 0bdb7c1..73715b3 100644
--- a/docs/api-phase1.md
+++ b/docs/api-phase1.md
@@ -639,6 +639,7 @@ B1-2 的退款/拒付复验依赖它。服务端凭据（`packageName` + service
 | `noticeEnabled` | `app.notice.enabled` | `true` | 公告入口开关 |
 | `coinUnlockEnabled` | `app.coin.unlock.enabled` | `true` | 金币解锁开关 |
 | `downloadEnabled` | `app.download.enabled` | `true` | 离线下载开关 |
+| `loginBackgroundUrl` | `app.login.background.url` | `""` | 登录页全屏海报背景；留空 App 用内置默认图。**建议尺寸 1170×2532**（iPhone 14 Pro Max 3× 整屏竖图），后台走 `/admin/media/upload/` 任意 bizType 上传后把返回的相对路径（`/files/login_bg/xxx.jpg`）写入即可 |
 
 **口径**：**只下发上述白名单键**（服务端硬编码白名单），后台配置里的其它键（可能含内部开关）
 **一律不下发**；库里缺键时用「契约默认值」兜底，**不返回 null 让客户端自己猜默认值**。
diff --git a/fruitshorts-app-api/src/main/java/com/fruitshorts/app/service/AppConfigService.java b/fruitshorts-app-api/src/main/java/com/fruitshorts/app/service/AppConfigService.java
index ab30c3d..48e0b18 100644
--- a/fruitshorts-app-api/src/main/java/com/fruitshorts/app/service/AppConfigService.java
+++ b/fruitshorts-app-api/src/main/java/com/fruitshorts/app/service/AppConfigService.java
@@ -35,6 +35,7 @@ public class AppConfigService {
         KEYS.put("noticeEnabled", new KeySpec("app.notice.enabled", "true"));
         KEYS.put("coinUnlockEnabled", new KeySpec("app.coin.unlock.enabled", "true"));
         KEYS.put("downloadEnabled", new KeySpec("app.download.enabled", "true"));
+        KEYS.put("loginBackgroundUrl", new KeySpec("app.login.background.url", ""));
     }
 
     private final SysConfigMapper sysConfigMapper;
diff --git a/fruitshorts-app-api/src/test/java/com/fruitshorts/app/controller/AppCreatorAndConfigContractTest.java b/fruitshorts-app-api/src/test/java/com/fruitshorts/app/controller/AppCreatorAndConfigContractTest.java
index 8397c0e..982428e 100644
--- a/fruitshorts-app-api/src/test/java/com/fruitshorts/app/controller/AppCreatorAndConfigContractTest.java
+++ b/fruitshorts-app-api/src/test/java/com/fruitshorts/app/controller/AppCreatorAndConfigContractTest.java
@@ -90,6 +90,7 @@ class AppCreatorAndConfigContractTest {
         whitelist.put("noticeEnabled", true);
         whitelist.put("coinUnlockEnabled", true);
         whitelist.put("downloadEnabled", true);
+        whitelist.put("loginBackgroundUrl", "");
         given(appConfigService.appConfig()).willReturn(whitelist);
 
         String body = configMvc.perform(get("/app/config"))
@@ -97,6 +98,7 @@ class AppCreatorAndConfigContractTest {
                 .andExpect(jsonPath("$.code").value(0))
                 .andExpect(jsonPath("$.data.agreementVersion").value("2026-10-01"))
                 .andExpect(jsonPath("$.data.forceUpdate").value(false))
+                .andExpect(jsonPath("$.data.loginBackgroundUrl").value(""))
                 .andReturn().getResponse().getContentAsString(java.nio.charset.StandardCharsets.UTF_8);
 
         // 没登录也能拿到（匿名）