与主站（tour-mate-platform）集成方式

1. 推荐调用链（C / B 共用形态）

HTTP（App 或 Admin）
  → Trigger Controller（协议、登录用户）
  → IAssistantApplicationService（Domain 入站 Port）
  → Assistant 编排（槽位 / 工作流步骤）
       ├─ ILlmPort（结构化输出）
       └─ Tools → 现有 IXxxApplicationService / Repository Port
  → 统一 Response + 审计落库

符合现有六边形：AI 是新的触发方式，不是新的业务真相来源。

---

2. 模块怎么切（示意，开干时再 ADR）

可选粒度（从轻到重）：

1. 包级：domain/assistant + infrastructure 适配器（起步够用）
2. Maven 模块：tour-mate-platform-assistant（边界清晰、依赖可控）
3. 独立服务：见《是否独立AI项目》

开干前按主仓 AGENTS.md 做摸底：是否已有类似 Port / TODO，避免并行造轮子。

---

3. C 端集成要点

点	做法
活动数据	复用现有活动查询/列表能力，扩展筛选 DTO
深链	与 App 路由表对齐，契约写入 docs/API
鉴权	同 App JWT；Tool 内按用户过滤
前端	对话气泡 + 活动卡片组件；点击走原生导航

4. B 端集成要点

点	做法
入口	Web Admin 独立页，角色校验
统计	优先复用 Stat / 订单 / 退款已有聚合；缺了再补查询，不让模型算
报告	对象存储或 DB 存 Markdown；保存前 approval
画像	只读聚合、脱敏；标注口径与 T+1 延迟

---

5. 数据与安全最低线

• 全链路 traceId / sessionId / taskId
• 记录：意图、工具名、参数摘要、耗时、Token、是否 HITL
• 提示词与检索文档分离：检索内容当数据不当指令
• 限流：按用户 / IP，防止刷模型烧钱
• 生产 Key 走配置中心/环境变量，不进仓库

---

6. 和推荐 / 画像 / IM 的衔接节奏

能力	MVP	以后
推荐	不依赖	排序加权
画像	不依赖	B 端分析维度；C 端个性化说明
IM	不挂入口	群内 @助手
内容审核	用户输入可过敏感词	同现有审核 Port