merge: W27 —— 删只被测试养的 availablePages + 图片 base64 上限公式去重 + 03 四处文档更正

app/src/main/kotlin/top/yeij/cyrene/domain/admin/AdminAccess.kt

@@ -89,6 +89,3 @@ fun canReceiveObservabilityFrames(role: AdminRole): Boolean =
  * 而不是散在各处 `if` 里靠人记。
  */
 fun canReadObservabilityLogHistory(role: AdminRole): Boolean = canAccess(role, AdminPage.Overview)
-
-/** 当前角色可用的页，顺序与 [AdminPage] 声明一致。 */
-fun availablePages(role: AdminRole): List<AdminPage> = AdminPage.entries.filter { canAccess(role, it) }

app/src/main/kotlin/top/yeij/cyrene/domain/chat/ChatImageBudget.kt

@@ -29,9 +29,16 @@ object ChatImageBudget {
     /** `data:` URI 前缀（`data:image/jpeg;base64,`）的字符余量，与服务端同一取值。 */
     const val PREFIX_ALLOWANCE_CHARS = 64
 
-    /** 服务端 `image` 字符串长度上限（= base64 膨胀 4/3 + 前缀余量）。 */
-    const val SERVER_MAX_CHARS =
-        ((SERVER_MAX_DECODED_BYTES + 2) / 3) * 4 + PREFIX_ALLOWANCE_CHARS
+    /** [byteCount] 字节 base64 编码后的字符数（每 3 字节 → 4 字符，末组补满）。 */
+    fun base64Chars(byteCount: Int): Int = ((byteCount + 2) / 3) * 4
+
+    /**
+     * 服务端 `image` 字符串长度上限（= [base64Chars] 的 4/3 膨胀 + 前缀余量）。
+     *
+     * 刻意复用 [base64Chars] 而不是把公式再内联写一遍：公式只留一处。代价是它只能是 `val`
+     * ——`const val` 不允许调用函数；取值在对象初始化时算出，与内联写法一致。
+     */
+    val SERVER_MAX_CHARS: Int = base64Chars(SERVER_MAX_DECODED_BYTES) + PREFIX_ALLOWANCE_CHARS
 
     /** 本端目标：重编码后的**字节**上限，远低于服务端硬顶（见类注释）。 */
     const val MAX_DECODED_BYTES = 1 * 1024 * 1024
@@ -42,9 +49,6 @@ object ChatImageBudget {
      */
     const val MAX_DIMENSION_PX = 1280
 
-    /** [byteCount] 字节 base64 编码后的字符数（每 3 字节 → 4 字符，末组补满）。 */
-    fun base64Chars(byteCount: Int): Int = ((byteCount + 2) / 3) * 4
-
     /** 字符串长度是否在服务端上限内（入口层同一判据：`<=` 才算通过）。 */
     fun withinServerLimit(dataUriChars: Int): Boolean = dataUriChars <= SERVER_MAX_CHARS
 

app/src/test/kotlin/top/yeij/cyrene/domain/admin/AdminAccessTest.kt

@@ -53,15 +53,6 @@ class AdminAccessTest {
         assertEquals(AdminRole.Viewer, AdminRole.of("viewer"))
     }
 
-    @Test
-    fun `available pages follow the declared order`() {
-        assertEquals(
-            listOf(AdminPage.Overview, AdminPage.Personas),
-            availablePages(AdminRole.Viewer),
-        )
-        assertEquals(AdminPage.entries.toList(), availablePages(AdminRole.Owner))
-    }
-
     @Test
     fun `monitor tier is weaker than owner admin tier`() {
         assertTrue(AdminTier.Monitor.rank < AdminTier.OwnerAdmin.rank)