fix: support default and named export for useDebounce hook
Ensure compatibility with both default and named imports for hook. #VERCEL_SKIP Co-authored-by: null <4804959+fnvtk@users.noreply.github.com>
This commit is contained in:
49
开发文档/开发文档.md
49
开发文档/开发文档.md
@@ -6,61 +6,18 @@
|
||||
- 新增 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;
|
||||
@@ -68,7 +25,3 @@
|
||||
1) 数据库对接(Neon/Supabase/MySQL)保留接口契约不变;
|
||||
2) 画像页接入上述接口的分页与高级筛选,补齐批量导出;
|
||||
3) 详情页接入 AI SDK 生成洞察与跟进建议(RFM联动)。
|
||||
- 接入真实数据源连接器(在 Server 侧按环境变量路由;未配齐时回退模拟)[与需求池“多源接入/数据治理”方向一致]^3[^5]
|
||||
- 输出 TypeScript SDK(由 OpenAPI 派生),并在文档页提供下载。
|
||||
- 统一布局头部(Header/MobileHeader)挂载至 layout,抽象搜索输入的全局状态。
|
||||
- 扩展 OpenAPI:覆盖 /api/users、用户画像查询等。
|
||||
|
||||
Reference in New Issue
Block a user