NEXUS2382/nexus-b2b-lead-generation

# NEXUS B2B 潜在客户情报 [](https://github.com/burkefit2382-wq/nexus-b2b-lead-generation/actions/workflows/azure-dev.yml) [](https://github.com/burkefit2382-wq/nexus-b2b-lead-generation/actions/workflows/deploy-backend.yml) [](https://github.com/burkefit2382-wq/nexus-b2b-lead-generation/actions/workflows/deploy-worker.yml) NEXUS 是一个 AI 驱动的 B2B 潜在客户情报平台，用于收集、丰富、评分、打包和销售高质量的潜在客户数据。它结合了 FastAPI 后端、TypeScript/Vite 前端、Stripe 结账、HubSpot 导出、Resend 履行、基于 Postgres 的会员跟踪以及优先使用 Azure 的部署自动化。 ## 标准生产部署 主要支持的企业部署路径是 **Render 前方的 Cloudflare**： - Cloudflare 负责处理 DNS、代理、CDN/静态资源交付和 WAF 控制 - Render 托管后端服务 - Neon 提供 Postgres - Resend、Stripe 和 HubSpot 是受支持的外部集成 参见： - [`backend/docs/architecture-overview.md`](backend/docs/architecture-overview.md) - [`backend/docs/deployment-runbook.md`](backend/docs/deployment-runbook.md) - [`backend/docs/resend-integration.md`](backend/docs/resend-integration.md) - [`backend/docs/stripe-integration.md`](backend/docs/stripe-integration.md) - [`backend/docs/hubspot-integration.md`](backend/docs/hubspot-integration.md) - [`backend/docs/incident-response-runbook.md`](backend/docs/incident-response-runbook.md) - [`backend/docs/secrets-management.md`](backend/docs/secrets-management.md) ## 代码库结构 ## 在线演示 - 生产店面： - 指挥中心仪表板： - 交互式工作流演示： - 后端健康检查： 指挥中心预览：  演示视频状态：该代码库现在在 [docs/portfolio-evidence.md](docs/portfolio-evidence.md) 中有一个专门的证据页面和演示脚本。请将录制的操作视频上传到 issue/PR 或一个稳定的视频 URL，然后用最终链接替换此说明。 ## 构建内容 - 用于打包 B2B 数据产品的潜在客户市场和结账流程。 - 用于潜在客户质量、数据丰富、履行和运营的指挥中心仪表板。 - 基于 Worker 的 OSINT 和 Tampa Bay 潜在客户生成流程。 - Stripe 会员结账和 webhook 处理。 - HubSpot CRM 导出和 Resend 履行通知路径。 - 通过 GitHub Actions 进行 Azure Container Apps 和 Azure Static Web Apps 部署。 - Render 和 Cloudflare 备用部署路径，用于保证弹性和进行边缘实验。 ## 架构 ``` flowchart LR User["Buyer / operator"] --> Web["Azure Static Web Apps frontend"] Web --> API["Azure Container Apps API"] API --> DB["Postgres / DATABASE_URL"] API --> Stripe["Stripe checkout + webhooks"] API --> Resend["Resend fulfillment email"] API --> HubSpot["HubSpot CRM export"] API --> Workers["Lead scraper + enrichment workers"] GitHub["GitHub Actions"] --> AZD["Azure Developer CLI"] AZD --> ACR["Azure Container Registry remote build"] ACR --> API Cloudflare["Cloudflare Worker fallback"] -. manual .-> Web Render["Render backend fallback"] -. manual .-> API ``` ## 证据快照 2026 年 7 月 16 日在本地验证： | 领域 | 结果 | |---|---| | 后端测试 | `27 passed, 1 warning`，耗时 7.23s | | 重点 app/worker 覆盖率 | 覆盖 `backend/app` 和 `backend/workers` 达 55% | | 整个后端覆盖率 | 包含旧版 `backend/server.py` 在内的 41% 基准 | | 前端构建 | Vite 生产构建在 812ms 内完成 | | 前端 bundle | `index.html` 0.41 kB，CSS 1.19 kB，gzip 前的 JS 3.60 kB | | 漏洞审计 | `npm --prefix frontend install` 报告 0 个漏洞 | 复现验证： ``` python -m pip install -r backend/requirements-dev.txt python -m pip install coverage PYTHONPATH=. python -m coverage run --source=backend/app,backend/workers -m pytest backend/tests python -m coverage report -m npm --prefix frontend install npm --prefix frontend run build ``` ## 代码库导览 - `backend/app/main.py` - FastAPI 应用程序和核心产品 endpoint。 - `backend/app/api` - 潜在客户和会员 API 模块。 - `backend/app/services` - Stripe、HubSpot、存储、数据库和配置服务。 - `backend/workers/tampa_bay_lead_worker.py` - 潜在客户 worker pipeline 和质量评分逻辑。 - `backend/tests` - API、结账、webhook 和 worker 质量测试。 - `backend/assets/dashboard-preview.png` - 用于作品集 README 的当前仪表板截图。 - `frontend` - TypeScript/Vite 前端。 - `infra` - Azure Bicep 基础设施定义。 - `.github/workflows` - CI/CD 和部署自动化。 - `backend/docs` - API、架构、部署、可观测性、运营、路线图和安全说明。 ## 本地开发 后端： ``` python -m venv .venv source .venv/bin/activate python -m pip install -r backend/requirements-dev.txt uvicorn backend.app.main:app --reload --host 0.0.0.0 --port 8000 ``` 前端： ``` cd frontend npm install npm run dev ``` 验证： ``` npm --prefix frontend run build PYTHONPATH=. python -m pytest backend/tests ``` ## 部署 主要生产路径是通过 GitHub Actions 使用 Azure Developer CLI。`azd up` 会预配 Azure Container Registry、用于后端的 Azure Container Apps 以及用于前端的 Azure Static Web Apps。Render 和 Cloudflare 保留为手动的备用/边缘工作流。 必需的 GitHub Actions 变量： | 变量 | 描述 | |---|---| | `AZURE_CLIENT_ID` | 服务主体 / 托管身份客户端 ID | | `AZURE_TENANT_ID` | Azure AD 租户 ID | | `AZURE_SUBSCRIPTION_ID` | 目标订阅 ID | | `AZURE_ENV_NAME` | Azure 环境名称，例如 `nexus-dev` | | `AZURE_LOCATION` | Azure 区域，例如 `eastus2` | 所需的密钥包括 Stripe、Postgres、Resend 和 HubSpot 凭证。有关完整的部署路径，请参见 [backend/docs/deployment.md](backend/docs/deployment.md)。 ## 项目流程 NEXUS 应展示清晰的工程纪律： - 为面向作品集的改进开启专门的 issue。 - 使用短生命周期的分支，并创建包含屏幕截图、测试结果和性能说明的干净的 pull request。 - 使发布与可用的产品里程碑保持一致。 - 保持提交的范围明确且具有描述性，使用 `feat:`、`fix:`、`docs:`、`test:` 和 `ci:` 等前缀。 - 将覆盖率和 bundle 大小作为明确的质量指标进行跟踪。 ## 路线图 - 录制并附上一段 60-90 秒的产品操作视频。 - 将重点 app/worker 的覆盖率提高到 70% 以上。 - 添加由 CI 发布的覆盖率和构建大小 artifact。 - 发布一个包含屏幕截图、演示链接、部署说明和已知限制的版本。 - 继续将遗留的 server 行为迁移到经过测试的 FastAPI 服务模块中。

标签：AV绕过, B2B线索生成, FastAPI, Stripe支付, 人工智能, 命令控制, 商业智能, 客户关系管理, 密钥管理, 数据采集, 测试用例, 用户模式Hook绕过, 逆向工具