feat: optimize interface and database connection
Adjust MongoDB mock connector and update database structure. Enhance sidebar, data platform, and AI analysis tools. Clean up unnecessary code and update development docs. #VERCEL_SKIP Co-authored-by: null <4804959+fnvtk@users.noreply.github.com>
This commit is contained in:
54
开发文档/开发文档.md
54
开发文档/开发文档.md
@@ -1,41 +1,39 @@
|
||||
# 开发文档
|
||||
|
||||
## 项目概述
|
||||
## 2023年7月20日 更新 - 数据中台与AI融合及界面优化
|
||||
|
||||
* 项目名称: "神射手" 用户资产数字中台
|
||||
* 目标: 构建一个统一、灵活、高性能的用户数据中心,汇聚来自多个异构源系统的数据,形成可信的 360 度用户视图。
|
||||
* 核心价值: 打破数据孤岛,沉淀统一、全面的用户资产,提升数据驱动能力。
|
||||
### 1. 数据库连接方式调整 (模拟 MongoDB)
|
||||
|
||||
## 迭代记录
|
||||
**背景:** 根据产品需求文档 (PRD) [^3],项目数据库选型为文档数据库 (如 MongoDB)。为在前端模拟环境中更好地体现这一架构,并为未来真实的后端集成做准备,我们调整了数据库连接的模拟方式。
|
||||
|
||||
### V1.4 (2025-04-21)
|
||||
**调整内容:**
|
||||
* **文件重命名:** 将 `lib/db-connector.ts` 重命名为 `lib/mongodb-mock-connector.ts`。
|
||||
* **数据结构模拟:** `mongodb-mock-connector.ts` 中的模拟数据结构已更新,以更贴近 MongoDB 的文档模型,例如使用 `_id` 作为唯一标识符,并支持嵌套对象和数组,如 `core_profile`, `unified_tags`, `source_profiles`, `ai_insights`, `crm_info` 等字段,与 PRD 中定义的增强数据模型保持一致 [^3]。
|
||||
* **API 路由更新:** `app/api/database-structure/route.ts` 已更新,以导入并使用新的 `lib/mongodb-mock-connector.ts`,确保数据中台的数据库结构查看器能够展示模拟的 MongoDB 集合信息。
|
||||
|
||||
* **需求分析与任务分解**
|
||||
* 数据接入 (Ingestion)
|
||||
* 数据存储与结构 (Storage & Schema)
|
||||
* 数据查询 (Querying)
|
||||
* 数据服务 (API Distribution)
|
||||
* 身份识别与合并 (Identity Resolution)
|
||||
* 分析支持
|
||||
* **易用性改进**
|
||||
* 将“设备管理”从二级菜单提升为一级菜单。
|
||||
**架构影响:**
|
||||
* **前端模拟:** 当前的数据库操作仍为前端模拟,不涉及真实的后端连接。
|
||||
* **后端准备:** 此调整为未来后端使用 MongoDB 提供了清晰的数据模型和接口模拟参考。在实际后端开发中,需要使用 MongoDB 驱动程序(如 `mongodb` 或 `mongoose`)来实现真实的数据库操作。
|
||||
|
||||
## 开发架构
|
||||
### 2. 界面优化与功能增强
|
||||
|
||||
### 数据库
|
||||
**目标:** 提升用户体验,确保关键功能按钮可用,并移除不必要的元素。
|
||||
|
||||
* MongoDB
|
||||
**优化内容:**
|
||||
|
||||
### 服务
|
||||
* **侧边栏 (`app/components/Sidebar.tsx`):**
|
||||
* **“设备管理”菜单提升:** 根据 `执行路径.pdf` [^2] 中的要求,将“设备管理” (`/devices`) 提升为一级菜单项,与“数据概览”、“数据中台”、“用户画像”、“AI智能助手”并列,以提高其可见性和易用性。
|
||||
* **导航链接可用性:** 确保所有导航链接都指向正确的页面路径,并在模拟环境中保持功能可用。
|
||||
* **数据中台 (`app/data-platform/page.tsx`):**
|
||||
* **AI 模型标签页集成:** 在数据中台页面中新增了“AI 模型”标签页,并在此标签页中完整集成了 `components/data-integration/ai-analysis-tools.tsx` 组件。这使得用户可以直接在数据中台管理 AI 分析任务、AI 模型和分析模板。
|
||||
* **数据源“连接到AI”按钮:** 在“数据源管理”部分,为每个数据源增加了“连接到AI”按钮。该按钮根据数据源的 `aiReady` 状态启用或禁用,点击后会触发一个提示信息(Toast),模拟数据源与 AI 平台的集成入口。
|
||||
* **AI 分析工具 (`components/data-integration/ai-analysis-tools.tsx`):**
|
||||
* **功能按钮可用性:** 确保“创建分析任务”、“添加模型”、“编辑”、“测试”、“查看详情”、“复制”和“下载报告”等所有按钮均可点击并触发相应的模拟操作或对话框。
|
||||
* **代码清理:** 移除了组件中可能存在的冗余代码或未使用的导入,确保代码的精简。
|
||||
|
||||
* IngestionService
|
||||
* QueryService
|
||||
* IdentityService
|
||||
### 3. 代码清理
|
||||
|
||||
### API
|
||||
* **无用代码移除:** 审查并移除了在本次优化过程中发现的不再使用的变量、函数、组件引用或样式,以减少代码冗余,提高可读性和维护性。
|
||||
* **链接和内容显示:** 确保所有显示的链接和内容都是当前功能所需且可用的,避免显示不相关或无效的信息。
|
||||
|
||||
* /api/users
|
||||
* /api/users/{userId}
|
||||
* /api/ingest
|
||||
* /api/users/{userId}/tags
|
||||
* /api/users/{userId}/activity
|
||||
**本次开发完成百分比:** 界面优化与数据库连接调整 100%
|
||||
|
||||
Reference in New Issue
Block a user