AI导哈

跳过追踪演示平台

一个专业的跳过追踪概念验证平台，用于自动定位个人并收集联系信息，适用于回购公司、债务催收和法律专业人士。

  • by GautaVaid
  • JavaScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 GautaVaid/Skip_Tracing

使用说明

跳过追踪POC-专业演示平台

使用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配置

安装

  1. 克隆存储库

    git clone https://github.com/GautaVaid/Skip_Tracing.git
cd Skip_Tracing

  2. 安装依赖项

    # Install backend dependencies
cd server && npm install

# Install frontend dependencies  
cd ../client && npm install

  3. 环境设置

    # 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

  4. 数据库设置

    cd database
npm run migrate
npm run seed

  5. 启动开发服务器

    # Terminal 1: Backend
cd server && npm run dev

# Terminal 2: Frontend
cd client && npm run dev

  6. 打开应用程序

    • 前端：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部署
  • 后端：自动缩放容器编排
  • 数据库：带备份的生产数据库
  • 监控：全面的日志记录和警报

📈 性能基准

目标绩效

  • 搜索响应：平均<30秒
  • 页面加载时间：<3秒初始加载
  • API响应：非搜索端点<500ms
  • 运行时间：99.9%的可用性目标

优化功能

  • 重复搜索的结果缓存
  • 数据库查询优化
  • 前端代码拆分和延迟加载
  • 静态资产CDN

🤝 贡献

我们欢迎捐款！请看 贡献.md 有关以下内容的详细信息：

  • 行为准则
  • 开发设置
  • 拉取请求流程
  • 编码标准
  • 测试要求

获取帮助

  • 问题：为bug或功能请求创建GitHub问题
  • 讨论：使用GitHub讨论提问
  • 文档：检查 /docs 详细指南目录

📋 发展路线图

第一阶段：基础✅

  • [x] MCP堆栈配置和验证
  • [x] 仓库设置和Git工作流程
  • [x] 项目结构和文件

第二阶段：核心开发🚧

  • []数据库架构和后端API
  • []跳过跟踪引擎和Apify集成
  • []前端组件和用户界面

第3阶段：测试和质量📋

  • []全面的测试套件实施
  • []性能优化和基准测试
  • []安全审计和合规性验证

第四阶段：生产准备🎯

  • []导出功能和专业功能
  • []部署自动化和监控
  • []Beta用户入职和反馈收集

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

  • Apify平台 -跳过跟踪数据源集成
  • Supabase -数据库和后端服务
  • MCP协议 -AI驱动的开发加速
  • Beta用户 -宝贵的反馈和测试支持

内置于❤️ 使用6-Server MCP堆栈以获得最大的开发效率

通过人工智能驱动的专业工作流程，将数周的开发转化为数天

相关 MCP