跳到正文
☰
UA
评论中间件现状
重构前事实基线
审计日期 2026-08-12
◐
正在渲染文档...
此文档需要启用 JavaScript 才能渲染 Markdown 和 Mermaid 图。
# UA PIM 评论中间件现状文档 ## 范围 本目录用于固化重构前的系统事实。当前阶段只回答“系统现在是什么、如何运行、代码如何组织、哪些事实尚不可确认”，不定义目标架构。 系统主体是基于 Yii 2 Console、Redis Queue 和 MySQL 的多渠道评论中间件，覆盖京东、天猫/淘宝和抖音。`frontend` 与 `common` 仍主要是 Yii 模板；当前 `backend` 副本交付不完整，无法确认任何可运行的评论后台能力。 ## 阅读顺序 1. [现状审计约定](00-current-state-audit-contract.md)：证据优先级、术语、安全与完成定义。 2. [系统与数据架构](01-system-and-data-architecture.md)：运行组件、部署关系、表结构与 ER 图。 3. [业务功能与流程](02-business-functions-and-flows.md)：模块清单、分渠道采集/回复流程、状态与异常行为。 4. [代码分层与依赖](03-code-layering-and-dependencies.md)：目录职责、实际分层、依赖方向与耦合现状。 5. [四类事实补证](04-four-fact-supplement.md)：生产数据、任务运行、跨系统上下游和渠道真实协议。 ## 文档状态 | 文档 | 状态 | 说明 | | --- | --- | --- | | 审计约定 | Done | 已明确本轮现状调查的取证规则 | | 系统与数据架构 | Done（仓库范围） | 已覆盖组件、运行拓扑、表字典、逻辑 ER 和数据流 | | 业务功能与流程 | Done（仓库范围） | 已覆盖功能清单、渠道流程、状态、异常和人工运维路径 | | 代码分层与依赖 | Done（仓库范围） | 已覆盖目录职责、调用链、依赖矩阵和实际分层 | | 四类事实补证 | Partial（证据边界已明确） | 已补齐仓库、本机和历史证据；生产 DDL/数据、部署、真实上下游和完整渠道契约仍需外部采集 | 三份仓库范围内的静态调查和一份跨仓库/运行历史补证已经完成；整个系统现状基线仍为 **Partial**。当前已确认队列后端切换、部分历史 Worker 并发、相邻账户表跨库读取和渠道失败样本，但生产 DDL/数据剖面、稳定调度配置、回复记录生产方、评论消费者和完整渠道配额仍需外部证据。 ## 共同术语 | 术语 | 当前含义 | | --- | --- | | 渠道账户 | `app_info` 中的一条店铺/渠道凭据配置 | | 采集时间片 | `comments_limitation` 中用于评论抓取的时间范围记录 | | 回复游标 | 同一张 `comments_limitation` 表中，以 `replay_` 前缀记录的已扫描回复 ID | | 主任务 | 按店铺/时间片抓取评论或商品的 Queue Job | | 子任务 | 天猫详情抓取或抖音按商品抓取评论的 Queue Job | | 原始载荷 | 评论、详情或渠道响应序列化后的 JSON 字符串 | | 渠道适配器 | 当前各渠道的 `Client`/`HuFuClient`；它们尚未实现统一接口 | ## 尚需外部补证 - 生产数据库的完整 `SHOW CREATE TABLE`、索引、数据量、重复和状态聚合。 - Cron、Supervisor/systemd、容器编排、Queue Worker 启动参数及生产 Redis 计数。 - `jd_comments_reply`、`tmall_comments_reply` 的真实上游写入者和一条脱敏端到端链路。 - 评论与回复结果的下游读取、同步或报表消费者。 - 三个渠道的脱敏成功响应、官方限流规则、错误码及当前授权范围。 - 生产环境配置注入、密钥管理、日志采集和告警方式。