From 0d05986f8c80c5636f1f670605f1469326d86152 Mon Sep 17 00:00:00 2001
From: chenxing <chenxing@bestsch.com>
Date: Thu, 8 Oct 2026 23:27:33 +0800
Subject: [PATCH] =?UTF-8?q?feat(appearance):=20=E5=A4=96=E8=A7=82=E5=81=8F?=
 =?UTF-8?q?=E5=A5=BD=E5=90=8C=E6=BA=90=E8=AF=BB=E4=BB=A3=E7=90=86=E7=AB=AF?=
 =?UTF-8?q?=E7=82=B9=20GET=20/api/appearance=EF=BC=88oapi=20=E4=BB=A3?=
 =?UTF-8?q?=E7=90=86=E8=BD=AE=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- YschOpenCall(target=userhome) 经 open-gateway 签名直调 /oapi/appearance，JsonNode 整体透传（哑管道）
- 降级铁律：下游不可达 503（init 侧静默不动本地键），绝不伪装 200+全 null 清键
---
 .../api/AppearanceProxyController.java        | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 src/main/java/com/yunhai/notice/controller/api/AppearanceProxyController.java

diff --git a/src/main/java/com/yunhai/notice/controller/api/AppearanceProxyController.java b/src/main/java/com/yunhai/notice/controller/api/AppearanceProxyController.java
new file mode 100644
index 0000000..e3302fd
--- /dev/null
+++ b/src/main/java/com/yunhai/notice/controller/api/AppearanceProxyController.java
@@ -0,0 +1,61 @@
+package com.yunhai.notice.controller.api;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.yunhai.notice.config.Config;
+import com.yunhai.platform.openapi.core.YschOpenCall;
+import com.yunhai.platform.utils.model.BoaUser;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.http.HttpStatus;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.server.ResponseStatusException;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * 外观偏好同源读代理（oapi 代理轮 2026-10-08，全端统一形态）。
+ *
+ * <p>浏览器（通道 init 异步段）只与本应用【同源】取数——CAS 会话天然有效，无需 iframe 引导；
+ * 后端经 open-gateway 签名直调 UserHome（target=userhome，寻址走 yh.open.services，
+ * 勿写死 host）。设置入口收敛在 UserHome 设置中心，本端点【只读不写】。</p>
+ *
+ * <p>契约 = UserHome /oapi/appearance 出参【整体透传】（JsonNode 哑管道）：字段加减只在
+ * UserHome + 通道 init 两端演进，本应用零改动。现行字段 {@code {theme, avatar, logoUrl}}——
+ * theme/avatar 为服务端合成后的【生效值】（个人→学校→平台级联，不拆 my/sch）；
+ * null=未配置，init 侧清对应本地键回落默认观感。</p>
+ *
+ * <p>降级铁律：UserHome/网关不可达时【必须】以非 2xx 返回（503），绝不能伪装成 200+全 null——
+ * init 会把全 null 收敛成清键，等于 UserHome 停服一次就清空全员本地观感
+ * （对齐直连时代「fetch 失败静默、不动键」的语义）。</p>
+ */
+@RestController
+@RequestMapping(value = Config.API_PATH)
+public class AppearanceProxyController {
+
+    private static final Logger log = LoggerFactory.getLogger(AppearanceProxyController.class);
+
+    /** open_api_target 注册表中的 userhome；寻址 yh.call.targets → yh.open.services → 枚举兜底 */
+    private static final String TARGET_USERHOME = "userhome";
+
+    private final YschOpenCall openCall;
+
+    public AppearanceProxyController(YschOpenCall openCall) {
+        this.openCall = openCall;
+    }
+
+    @GetMapping("appearance")
+    public JsonNode appearance(BoaUser authUserWithDept) {
+        try {
+            Map<String, String> q = new HashMap<>();
+            q.put("userId", String.valueOf(authUserWithDept.getId())); // 服务端取登录人，不收前端参数
+            return openCall.get(TARGET_USERHOME, "/oapi/appearance", q, JsonNode.class);
+        } catch (Exception e) {
+            log.warn("[appearance] UserHome 外观偏好不可达（503，init 侧静默不动本地键）userId={}：{}",
+                    authUserWithDept.getId(), e.toString());
+            throw new ResponseStatusException(HttpStatus.SERVICE_UNAVAILABLE, "appearance unavailable");
+        }
+    }
+}