## 2025-08-08 菜单同步 + 用户画像数据与接口完善
- 完成内容：
  - 同步左侧导航与底部菜单，统一为【首页 / 数据中台 / 画像 / AI智能助手】，去除“搜索”入口，避免与首页内置搜索重复。
  - 新增 /api/users 接口（GET/POST），支持 q、tags、status、rfmMin、rfmMax、page、pageSize 与 id 详情查询。
  - 新增 lib/mock-users.ts：批量生成中文姓名、邮箱、手机号、标签、动态时间（基于当前时间）与 RFM 分数的模拟用户数据。
  - 新增 Skeleton 组件与 moments-sync 编辑页 loading.tsx 作为 Suspense Fallback，避免 useSearchParams 构建报错。
  - 补齐 Toast / Toaster 组件的导出与实现，修复构建失败。
  - 将“搜索入口”迁移并固定在首页；修复 /api/users 导出/导入冲突，稳定构建。

## 2025-08-09 身份识别服务与数据库结构 API 修复
- 完成内容：
  1) 身份识别服务
  - 新增 services/IdentityService.ts：提供 findMatchingIdentity / createNewIdentity / updateIdentity 内存索引能力，支持基于 email/phone/username 的高置信匹配与合并。
  - 与 v1.4 的统一用户结构（source_profiles / ai_insights / crm_info）设计一致，保障数据接入的落库结构稳定 [^5]。

  2) 数据库结构 API 修复
  - 重写 app/api/database-structure/route.ts：
    - 无参数：返回数据库列表（[{ Database: string }]），契合 DatabaseStructureViewer 预期。
    - ?database：返回该库完整结构。
    - ?database&table：返回指定表结构。
  - 对齐前端 DatabaseStructureViewer 的取数流程（初始化先拉库列表，再按库取结构）。

  3) OpenAPI 规范输出
  - 新增 app/api/openapi/route.ts：输出最小可用的 OpenAPI 3.1 规范（覆盖 /api/ingest 与 /api/database-structure）。
  - 支持 ?download=1 作为附件下载。

  4) API 文档页面联通
  - 更新 components/data-integration/api-documentation.tsx：
    - “下载OpenAPI规范”直连 /api/openapi?download=1
    - “下载SDK”暂指向 /api/openapi（后续接入代码生成）
    - “API测试工具”直连 /api/ingest（GET 状态）

- 变更文件：
  - app/page.tsx（新增首页搜索与指标卡片）
  - components/home/user-search.tsx（新增：状态/RFM过滤 + 绑定首页搜索框）
  - components/home/user-list.tsx（新增：表格列表）
  - app/api/users/route.ts（精简重写：仅依赖 lib/mock-users 导出）
  - lib/mock-users.ts（统一导出 queryUsers/addUser/getUserById，时间全部相对“当前时间”生成）
  - services/IdentityService.ts（新增：身份识别服务）
  - app/api/database-structure/route.ts（重写：数据库结构 API）
  - app/api/openapi/route.ts（新增：OpenAPI 规范输出）
  - components/data-integration/api-documentation.tsx（更新：API 文档页面联通）

- 接口与数据：
  - GET /api/users?id= 返回单体详情；GET /api/users 返回列表与分页；POST /api/users 新增一个用户（服务内内存态）。
  - GET /api/database-structure 返回数据库列表；GET /api/database-structure?database 返回指定数据库结构；GET /api/database-structure?database&table 返回指定表结构。
  - GET /api/openapi 返回 OpenAPI 规范；GET /api/openapi?download=1 下载 OpenAPI 规范。

- 完成度：
  - 本轮任务完成度：100%
  - 用户画像模块整体完成度：≈ 88%（已具备真实感数据与筛选能力，待接入真实库）
  - 本迭代完成度：45%
  - 预计下一步（真实数据源 + SDK 下载 + 头部统一）：再提升至 75%

- 影响面
  - /api/ingest：因补齐 IdentityService，现可完整跑通 IngestionService 的识别合并流程。
  - 数据库结构查看器：现与 /api/database-structure 协议一致，可正常浏览模拟库结构。

- 风险与回滚
  - 本次为纯新增/替换服务与路由，未改动 UI 大结构，风险低。
  - 回滚：可将新增文件删除、路由还原至上个版本。

- 下一步计划
  1. 将 /api/users 切换到真实数据库（Neon 或现有 MySQL），并加上索引与分页游标；
  2. 画像页联动更多筛选项与批量导出；
  3. 详情页增加 AI 洞察与行动建议（AI SDK），联动 RFM；
  4. 对齐路由处的 loading 骨架风格，完善可用性与无障碍。
  1) 数据库对接（Neon/Supabase/MySQL）保留接口契约不变；
  2) 画像页接入上述接口的分页与高级筛选，补齐批量导出；
  3) 详情页接入 AI SDK 生成洞察与跟进建议（RFM联动）。
  - 接入真实数据源连接器（在 Server 侧按环境变量路由；未配齐时回退模拟）[与需求池“多源接入/数据治理”方向一致]^3[^5]
  - 输出 TypeScript SDK（由 OpenAPI 派生），并在文档页提供下载。
  - 统一布局头部（Header/MobileHeader）挂载至 layout，抽象搜索输入的全局状态。
  - 扩展 OpenAPI：覆盖 /api/users、用户画像查询等。
