From 77a37fce123ab157f1dd0f94b7c1a139f2e99e17 Mon Sep 17 00:00:00 2001 From: wangjia <809946525@qq.com> Date: Sun, 12 Jul 2026 08:40:55 +0800 Subject: [PATCH] =?UTF-8?q?docs(design):=20=E8=B4=A6=E6=88=B7/=E8=AE=BE?= =?UTF-8?q?=E7=BD=AE/=E8=81=94=E7=B3=BB=20=E4=BF=A1=E6=81=AF=E6=9E=B6?= =?UTF-8?q?=E6=9E=84=E9=87=8D=E6=9E=84=20Spec=20=E2=91=A0(=E5=8E=BB?= =?UTF-8?q?=E9=87=8D+=E5=BD=92=E4=BD=8D,=E5=90=AB=E9=82=80=E8=AF=B7/?= =?UTF-8?q?=E9=80=9A=E7=9F=A5=E9=A2=84=E7=95=99=E4=BD=8D)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_013nMthbVEmQquxBRKb9Fj8u --- docs/account-ia-reorg-design.html | 164 ++++++++++++++++++++++++++++++ docs/index.html | 5 + 2 files changed, 169 insertions(+) create mode 100644 docs/account-ia-reorg-design.html diff --git a/docs/account-ia-reorg-design.html b/docs/account-ia-reorg-design.html new file mode 100644 index 0000000..fd981eb --- /dev/null +++ b/docs/account-ia-reorg-design.html @@ -0,0 +1,164 @@ + + + + + +账户 / 设置 / 联系 信息架构重构 — 设计 + + + +
+← 文档索引 +

账户 / 设置 / 联系 信息架构重构

+

设计文档 · 2026-07-12 · Spec ① / 3(② 推广激励 · ③ 系统通知 另立）· 状态 待评审

+ +
+问题:账户相关内容散在 App 的 Account / Settings / Contact / Redeem 四处 + Web 用户中心,大量重复(联系渠道 3 处、语言/主题 2 处、购买入口 3 处、Web 全套账户功能与 App 重叠)。用户找不到订单、点了没反应,根子是入口混乱。
+决策(已定):App 自足、Web 退居次要 —— 所有账户功能在 App 原生做完,每个功能只有一个家;Web 仅在 Settings 底部留一个低调入口。推广奖励双方都得,兑换码保留,Web 链接保留。 +
+ +

1 · 原则

+ + +

2 · 去重台账

+ + + + + + + +
重复项现在(乱)收敛到(唯一家)
联系渠道(TG/邮箱/官网)ContactPage + ContactScreen + Redeem「去哪买」×3Contact 页;Redeem 删「去哪买」
语言 / 主题Account 卡 + Settings ×2Settings·外观;Account 删
购买入口Account + Settings + Redeem 散 3 处Account·购买&订单块 + 会员横幅按钮;Settings 删
Web 用户中心Overview/订阅/设备/设置/兑换/邀请 全套,和 App 重叠弱化:Settings·关于 底部一个低调「网页版」链接
协议 / 版本Account 卡 + SettingsSettings·关于
+ +

3 · 目标结构

+
+

桌面版(侧栏)

+
侧栏 6 项 +├ Connect +├ Servers +├ Stats +├ Account ← 提为一级 +├ Settings +└ Contact +顶栏 ······· 🔔 通知 (红点) + +Account(账户中心) +├ 会员横幅 Renew/Upgrade→购买页 +├ 购买 & 订单 & 兑换 +│ ├ 购买套餐 → PurchaseScreen +│ ├ 我的订单 → OrdersScreen +│ └ 兑换码 → RedeemScreen(仅码) +├ 邀请好友 → InviteScreen(得会员) +├ 账户信息 邮箱 / 密码 +└ 我的设备 → DevicesScreen + +Settings(应用设置) +├ 连接 自启/自动连/智能分流/KillSwitch +├ 外观 语言 / 主题 +└ 关于 协议 / 版本 / 检查更新 + · 低调「网页版用户中心」 + +Contact +└ Telegram / 邮箱 / 官网 + 服务时间
+
+

移动版(底 Tab)

+
底 Tab 4 项 +├ Connect +├ Servers +├ Stats +└ Account +顶栏 ······· 🔔 通知 (红点) + +Account tab +├ 会员横幅 Renew/Upgrade→购买 +├ 购买 & 订单 & 兑换 +├ 邀请好友 +├ 账户信息 +├ 我的设备 +├ 设置 → 全屏下钻 +└ 联系我们 → 全屏下钻 + +设置 / 联系 / 购买 / 订单 / +设备 / 邀请 均从 Account +全屏 push;语言/主题在 +「设置」子页内。
+

规则:移动端无侧栏,故 Account 内多「设置/联系」两个入口;桌面端不显(侧栏已有)。判据 context.formFactor。

+
+
+ +

4 · 新功能预留位（细节见 ②③）

+

🔔 通知(Spec ③)

+

顶栏铃铛 + 未读红点 → 通知收件箱(列表,已读态)。重要通知走顶部横幅(复用现有更新横幅)。后端已有 GET /v1/notices 底子;类型 新闻/功能/重要。参考 jiu。

+

邀请好友(Spec ②)

+

Account 一个「邀请好友得会员」入口 → 邀请页(邀请码/链接 + 奖励进度)。双方都得:邀请人 & 被邀人各得订阅天数。行为奖励:注册 / 首购 / 加入 TG channel 等。克制的偶发提示(账户页或特定动作后的低调 banner,不打扰)。

+ +

5 · 落地改动(Flutter)

+ + + + + + + + +
文件改动
navigation_provider.dartNavView 加 account 一级 + invite 子页;桌面侧栏列表加 Account
desktop_shell.dart侧栏加 Account 项;顶栏加通知铃铛;content() 加 invite/orders 等分支
account_page.dart按目标顺序重排卡片;加邀请入口;删语言/主题/协议卡(移 Settings);移动端才显 设置/联系
settings_page.dart删购买/订单卡;归拢 连接/外观/关于 三组;Web 链接降到关于底部
account_screens.dartRedeemScreen 删「去哪买」渠道卡(仅留兑换码);ContactScreen 保持渠道唯一
content_top_bar.dart / 顶栏加通知铃铛槽(Spec ③ 接线)
+ +

6 · 决策日志

+ + +

7 · 不在本 spec

+

推广激励的奖励规则引擎/归因/防刷/邀请页细节(Spec ②);通知的类型/下发/定向/收件箱交互(Spec ③);Web 用户中心自身的精简(单独排期)。本文只定 App 的页面骨架与入口归位,并为 ②③ 预留落点。

+ +
+ + diff --git a/docs/index.html b/docs/index.html index d310d48..e9b82b4 100644 --- a/docs/index.html +++ b/docs/index.html @@ -44,6 +44,11 @@

设计方案 / Specs

+ +
账户 / 设置 / 联系 信息架构重构（Spec ①/3）HTML
+
去重 + 归位：App 自足、Web 退居次要；每功能一个家。桌面提 Account 为一级侧栏项，移动 Account tab 含设置/联系下钻。收敛联系渠道(×3→1)/语言主题(×2→1)/购买入口(散3→Account)。为「🔔 通知」(顶栏铃铛)+「邀请好友」(账户入口)预留落点。决策：奖励双方都得、兑换码保留、Web 链接保留。后续 ②推广激励 ③系统通知 另立 spec。
+
docs/account-ia-reorg-design.html
+
CI/CD 全流程（tag 触发编译/发版/部署）HTML
#30。参考 jiu 的 scripts/ci + .gitea/workflows：tag 触发（site-v*/server-v*/client-v*）→ 编译 → 测试 → Gitea release → 部署。runner 混合（nas=官网+服务端容器化 / mac=Android+macOS / windows=Windows）。服务端部署固化 F3/F4「备份→migrate→换二进制→重启→健康检查+回滚」；官网部署 pangolin.yanmeiai.com；客户端 apk/dmg/exe 挂 release 喂官网下载链接。密钥作用域：Apple/token 账户级、部署 key/Android keystore 仓库级。范围 A~F（排除 iOS/#26/#25）。