Suggestion 模块说明（统一入口）

本文档是 suggestion 模块的统一入口，遵循 docs/DEVELOPER_GUIDE.md 的“单一入口、避免分叉”原则。

1. 当前状态（Phase 2）

• 仅保留 Suggest 自动补全能力
• 不支持结果直达（with_results / result_size / products[] 已移除）
• 索引采用版本化发布：
  • 物理索引：{ES_INDEX_NAMESPACE}search_suggestions_tenant_{tenant_id}_v<timestamp>
  • 读别名：{ES_INDEX_NAMESPACE}search_suggestions_tenant_{tenant_id}_current
• 支持增量更新（watermark + overlap）

2. 文档导航（唯一推荐顺序）

1. ARCHITECTURE_V2.md：架构与设计原则
2. RUNBOOK.md：构建/发布/验证流程
3. TROUBLESHOOTING.md：常见问题排查

3. 命令入口

• 全量或增量构建：

./scripts/build_suggestions.sh <tenant_id> --mode full
./scripts/build_suggestions.sh <tenant_id> --mode incremental

• 一键重建 + 验证：

./scripts/rebuild_suggestions.sh <tenant_id>

4. API 约定（简版）

• 端点：GET /search/suggestions
• 参数：q, size, language
• Header：X-Tenant-ID

示例：

curl "http://localhost:6002/search/suggestions?q=shi&size=10&language=en" \
  -H "X-Tenant-ID: 162"