refactor(tenant): drop legacy plugin_installations, migrate monitoring to desktop_clients

Hard cutover from the browser-extension plugin flow to desktop clients: remove plugin_installations/plugin_sessions tables and related service, handler, router, and generated model code; migrate monitoring quotas and collector types to desktop_clients (UUID primary_client_id); recreate platform_access_snapshots keyed by client_id; update dev-seed and callback types accordingly; mark legacy design docs as historical. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 13:52:35 +08:00
parent f5a1cd81b2
commit 5ff2e2e74c
25 changed files with 535 additions and 1384 deletions
@@ -1,4 +1,6 @@
-# AI 品牌曝光监测系统技术方案 V4
+# AI 品牌曝光监测系统技术方案 V4（旧版设计）
+
+> 旧版设计说明：本文描述的是基于浏览器插件采集、`installation_token`、`/api/plugin/monitoring/*` 的旧监控方案。自 2026-04-20 起，当前实现已切换到 `desktop_clients` / desktop client 架构。本文保留用于工作记录与方案追溯，不再作为当前实现依据。

 ## 1. 文档信息

@@ -6,7 +8,7 @@
 | --- | --- |
 | 文档名称 | AI 品牌曝光监测系统技术方案 V4（插件采集 + 配额约束） |
 | 文档版本 | V4.0 |
-| 文档状态 | 待评审 |
+| 文档状态 | 旧版设计（保留工作记录） |
 | 创建日期 | 2026-04-08 |
 | 基线文档 | `docs/ai-brand-monitoring-tech-design-v3.md` |
 | 适用范围 | 数据追踪模块全部页面 |
@@ -1,4 +1,6 @@
-# AI 品牌曝光监测系统技术方案 V5
+# AI 品牌曝光监测系统技术方案 V5（旧版设计）
+
+> 旧版设计说明：本文描述的是基于浏览器插件采样、`plugin_installations`、`primary_installation_id`、`/api/plugin/monitoring/*` 的旧监控方案。自 2026-04-20 起，当前实现已切换到 `desktop_clients` / desktop client 架构。本文保留用于工作记录与方案追溯，不再作为当前实现依据。

 ## 1. 文档信息

@@ -6,7 +8,7 @@
 | -------- | --------------------------------------------------------------------- |
 | 文档名称 | AI 品牌曝光监测系统技术方案 V5（插件采样首期交付 / API 精确采集预留） |
 | 文档版本 | V5.9                                                                  |
-| 文档状态 | 待评审                                                                |
+| 文档状态 | 旧版设计（保留工作记录）                                              |
 | 创建日期 | 2026-04-09                                                            |
 | 基线文档 | `docs/ai-brand-monitoring-tech-design-v4.md`                          |
 | 适用范围 | 数据追踪模块全部页面                                                  |
@@ -1,5 +1,7 @@
 # GEO 双后台与后端技术架构方案 V1

+> 工作记录说明：本文仍保留作为历史架构记录。其中涉及浏览器插件执行链路、`/api/callback/plugin/*`、`plugin_sessions`、`installation_token` 的相关章节，自 2026-04-20 起视为旧版设计；当前实现请以 desktop client 方案和最新代码为准。
+
 ## 1. 文档信息

 | 项目 | 内容 |
@@ -1,4 +1,6 @@
-# V1 技术方案：绑定媒体账号与手动发送文章
+# V1 技术方案：绑定媒体账号与手动发送文章（旧版设计）
+
+> 旧版设计说明：本文描述的是基于浏览器插件回调、`plugin_sessions`、`/api/callback/plugin/*` 的旧方案。自 2026-04-20 起，当前实现已切换到 desktop client 架构。本文保留用于工作记录与方案追溯，不再作为当前实现依据。

 > 口径说明：本文的插件执行流程、接口路径与会话模型已同步到主架构文档 [geo-platform-ops-admin-tech-architecture-v1.md](D:/project/geo/docs/geo-platform-ops-admin-tech-architecture-v1.md) 的 `§13.8 浏览器插件执行面闭环`、`§13.6.3 插件回调与内部接口`、`§13.6.4 统一错误响应与错误码`。若两份文档存在任何冲突，以主架构文档为准。

@@ -1,4 +1,6 @@
-# Media Publisher Extension Runtime V1
+# Media Publisher Extension Runtime V1（旧版设计）
+
+> 旧版设计说明：本文描述的是基于浏览器插件、`plugin_installations`、`plugin_sessions` 的旧执行方案。自 2026-04-20 起，当前实现已切换到 `desktop_clients` / desktop client 架构。本文保留用于工作记录与方案追溯，不再作为当前实现依据。

 ## Goal

@@ -0,0 +1,36 @@
+# 2026-04-20 Legacy Plugin Design Status
+
+## 背景
+
+2026-04-20 这次代码与数据库清理，已经移除了旧浏览器插件链路中的 `plugin_installations`、`plugin_sessions` 及其主要业务引用，并将监控主链路切换到 `desktop_clients` / desktop client 体系。
+
+## 决策
+
+本次**不删除**历史设计文档。
+
+保留原因：
+
+- 作为架构演进的工作记录，方便回溯旧方案的边界、假设和历史实现背景
+- 便于对照为什么当前实现从 browser extension 迁移到 desktop client
+- 避免后续排查历史字段、旧迁移、旧接口时失去上下文
+
+## 本次文档处理方式
+
+对明显描述旧插件执行模型的文档，统一补充“旧版设计”标识；对仍有其他参考价值的综合架构文档，补充“相关章节为旧版设计”的说明，而不删除正文内容。
+
+## 已标记文档
+
+- `docs/media-publisher-extension-runtime-v1.md`
+- `docs/media-binding-and-publish-v1.md`
+- `docs/ai-brand-monitoring-tech-design-v4.md`
+- `docs/ai-brand-monitoring-tech-design-v5.md`
+- `docs/geo-platform-ops-admin-tech-architecture-v1.md`
+
+## 当前口径
+
+当前实现以 desktop client 架构为准，旧插件设计文档仅用于历史追溯，不再作为新开发或现状判断依据。
+
+建议优先参考：
+
+- `docs/superpowers/specs/2026-04-18-electron-desktop-client-design.md`
+- 代码中的 `desktop_clients`、`/api/desktop/*`、监控与发布最新实现