mypoke-web :3000
UI + BFF · 产品唯一入口
- Auth：注册 / 登录 / 重置（Resend）
- Catalog / Search：调 TCGdex MCP
- 以图搜卡：调 Agent 识别图片文字
- 已有 / 有过 / 想要：用户卡片副本（卡册）
- 智能估价：调用 Agent
- 智能估品相：调用 Agent
- Agent / RAG Client：超时、凭证、错误映射
架构说明
MyPoke.trade 以三个独立服务部署：
- mypoke-web（UI + BFF）
- poketrade-agent（任务型 Agent）
- poke-rag（检索与索引增强知识库 · Corpus 框架）
浏览器只访问 Web；Agent / RAG 仅服务间调用。
架构目标
| 目标 | 含义 |
|---|---|
| 目录可浏览 | 未登录可查 TCGdex、搜索（含以图搜卡）、看印刷版详情 |
| 收藏可持久 | 已有 / 有过 / 想要副本存 App PostgreSQL，按用户隔离 |
| AI 可辅助 | 独立 Agent：读卡、目录定位、品相、估价、翻译、缺价估算 |
| 知识可检索 | 独立 RAG：Corpus 框架（仓库版本化语料）→ embedding → retrieve / prefetch |
| 故障可降级 | Web / Agent / RAG / MCP / LLM 任一失败不得拖垮可浏览面 |
| 时延可预期 | 软提示约 10s；同步 task 就绪目标 ≤20s |
| 可独立演进 | 三进程独立发布与扩缩（ADR-006） |
逻辑视图
分层对应 specs/architecture.md §2：Browser → WebApp BFF → Agent / RAG → 外部与数据。
边界原则
| 原则 | 含义 |
|---|---|
| 浏览器只访问 WebApp | 不直连 Agent、RAG、LLM、MCP、数据库或密钥。 |
| 三服务边界不可合并为长期架构 | Web 管会话与业务落库；Agent 管推理循环；RAG 管知识检索与索引。 |
| WebApp BFF 汇聚产品面 | 鉴权、分页、错误码、i18n messageKey；以服务凭证调用 Agent / RAG。 |
| Agent 无用户业务库写权限 | 返回结构化结果；Web 写入 valuations / 展示候选。 |
| MCP 只做工具边界 | Web（目录 / 文字搜）与 Agent（C2）均可调用；业务规则留在 Collection / prompts。 |
| RAG 的 Corpus 与索引由 RAG 服务所有 | 语料经 Corpus 框架离线入库；Agent 仅经 HTTP 取 top-k。 |
服务职责
poketrade-agent :3101
LLM：qwen / 千问。能力：
- C1 读卡
- C2 目录定位（MCP）
- C3 知识检索（RAG）
- C4 品相（图片识别与 OCR）
- C5 卡片按品相估价
- C6 卡片内容翻译
- C7 缺挂牌市价估算
poke-rag :3102
检索 / prefetch / build-index
知识层采用 Corpus 框架（Git 真相源）
- Corpus：版本化 Markdown
- 路径：
knowledge/corpus/{topic} - condition / valuation / variant / auth
- Embedding：qwen / 千问
- 索引：PostgreSQL + pgvector
- 调用：Agent 同步；Web 异步 prefetch
