跳过追踪POC-专业演示平台
 ](https://nodejs.org/)  
使用6服务器MCP堆栈构建的专业跳过跟踪演示，可实现最大的开发效率和企业级质量。
🎯 项目概述
跳过跟踪POC 是一个概念验证演示平台，为回购公司、收债人和法律专业人士展示了自动跳过跟踪功能。该系统汇总了来自20多个经过验证的来源的数据，以定位个人并收集具有专业信心评分的联系信息。
主要特点
- ⚡ 实时多源搜索 -同时查询20+个数据库
- 🎯 信心评分 -基于人工智能的结果验证和排名
- 📊 专业报道 -带有品牌标识的PDF/CSV导出
- 📱 移动响应 -适用于所有设备和浏览器
- 🔒 隐私合规 -符合GDPR/CCPA的数据处理
- 🚀 企业就绪 -具有全面测试的可扩展架构
成功指标目标
- 50+测试用户 测试演示
- 60%+正面反馈 关于概念验证
- 30秒以下 搜索响应时间
- 95%以上的正常运行时间 在beta测试期间
🏗️ MCP堆栈架构
该项目利用了 6服务器MCP堆栈 专业发展：
| MCP服务器 | 用途 | 状态 |
|---|---|---|
| 🗂️ 文件系统 | 直接文件操作和管理 | ✅ 已配置 |
| 🔧 Git | 专业版本控制工作流程 | ✅ 已配置 |
| 🐙 GitHub | 项目管理和协作 | ✅ 已配置 |
| 🎭 剧作家 | 全面测试和质量保证 | ✅ 已配置 |
| 🔍 Apify | 跳过跟踪功能和验证 | ✅ 已配置 |
| 🗄️ Supabase | 数据库操作和分析 | ✅ 已配置 |
🚀 快速开始
先决条件
- Node.js 18+ 和npm
- Git 用于版本控制
- Supabase账户 用于数据库
- 指定帐户 用于跳过跟踪API
- 克劳德桌面 具有MCP配置
安装
- 克隆存储库
git clone https://github.com/GautaVaid/Skip_Tracing.git
cd Skip_Tracing- 安装依赖项
# Install backend dependencies
cd server && npm install
# Install frontend dependencies
cd ../client && npm install- 环境设置
# Copy environment template
cp .env.example .env
# Configure your API keys:
# - APIFY_TOKEN=your_apify_token
# - SUPABASE_URL=your_supabase_url
# - SUPABASE_ANON_KEY=your_supabase_key- 数据库设置
cd database
npm run migrate
npm run seed- 启动开发服务器
# Terminal 1: Backend
cd server && npm run dev
# Terminal 2: Frontend
cd client && npm run dev- 打开应用程序
- 前端：http://localhost:3000 - 后端API：http://localhost:8000 - API文件：http://localhost:8000/docs
📁 项目结构
Skip_Tracing/
├── client/ # React frontend application
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ ├── pages/ # Page-level components
│ │ └── utils/ # Frontend utilities
│ └── package.json
├── server/ # Node.js backend API
│ ├── routes/ # API endpoint definitions
│ ├── engines/ # Skip tracing engine core
│ ├── actors/ # Apify actor integrations
│ └── package.json
├── database/ # Database schema and migrations
│ ├── schema/ # Supabase table definitions
│ └── migrations/ # Database migration files
├── tests/ # Comprehensive test suite
│ ├── e2e/ # End-to-end tests (Playwright)
│ ├── api/ # API integration tests
│ └── unit/ # Unit tests
├── docs/ # Project documentation
├── deployment/ # Deployment configuration
└── config/ # MCP and application configuration🧪 测试
运行测试套件
# Run all tests
npm run test
# Run specific test types
npm run test:unit # Unit tests
npm run test:api # API integration tests
npm run test:e2e # End-to-end tests (Playwright)
npm run test:performance # Performance benchmarks测试覆盖率
- 目标：代码覆盖率超过80%
- 当前：将在首次试运行后显示
- 报告：生成于
coverage/目录
🔧 开发工作流程
分支策略（GitFlow）
- 主要的 -生产就绪代码
- 开发 -功能集成分支
- 特征/ -个性化特征开发
- 修补程序/ -关键生产修复
- 释放/ -发布准备
承诺标准
我们使用 常规承诺:
feat: add skip trace result confidence scoring
fix: resolve mobile responsive layout issues
docs: update API documentation for search endpoints
test: add end-to-end tests for export functionality代码质量
- ESLint -代码过滤和样式执行
- 更漂亮 -代码格式
- 哈士奇 -Git挂钩用于质量门
- 文件限制 -每个文件最多500行
📊 API文档
核心终点
搜索操作
POST /api/search-执行跳过跟踪搜索GET /api/search/:id-检索搜索结果DELETE /api/search/:id-取消当前搜索
出口业务
POST /api/export/pdf-生成PDF报告POST /api/export/csv-生成CSV导出POST /api/export/email-向用户发送电子邮件报告
分析
GET /api/analytics/dashboard-获取分析仪表板数据POST /api/analytics/event-跟踪用户交互事件
速率限制
- 搜索API：每个IP每分钟10个请求
- 导出API：每个IP每分钟5个请求
- 分析API：每个IP每分钟100个请求
🔒 安全与隐私
数据保护
- 所有PII在静止和传输过程中都是加密的
- 搜索结果将在24小时后自动清除
- 演示不需要用户身份验证（匿名使用）
- 符合GDPR/CCPA的数据处理程序
API安全
- 所有端点的速率限制
- 输入验证和净化
- XSS和SQL注入保护
- 前端域的CORS配置
🚀 部署
发展
- 前端：已部署到开发服务器
- 后端：使用Docker进行容器化
- 数据库：Supabase云实例
生产（未来）
- 前端：带缓存的CDN部署
- 后端：自动缩放容器编排
- 数据库：带备份的生产数据库
- 监控：全面的日志记录和警报
📈 性能基准
目标绩效
- 搜索响应：平均\ *通过人工智能驱动的专业工作流程，将数周的开发转化为数天*