JD CRED VIP–全栈工作区
此存储库汇集了 JD CRED VIP 操作后端和 JDTalk 前端/代理。每个子项目都在monorepo中保留自己的依赖关系和文档。
.
+-- jdcredvip-mcp/ # backend: motor de triagem, automações e serviços auxiliares
+-- jdtalk/ # frontend + agent runtime do JDTalk项目
jdcredvip-mcp/ – 分拣和自动化引擎
Node.js 后端（Express + Knex）和辅助脚本（ES Modules/Python）。主要资源：
- 客户分类（
POST /triagemJD CRED VIP产品规则更新。 - 目标发布/查询（
/api/publicar-meta,/api/metas,/api/dashboard）在关系型数据库（Postgres或MySQL）中持久性。 - 仪表板web em
/dashboard提供最新的数据。 - 脚本em
scripts/标准化电子表格、生成博客资产以及通过 Blogger API 发布文章。 - Crefaz/Nexxo集成，拥有供投标、合同和佣金使用的专用存储空间。
文件？或 ： jdcredvip-mcp/README.md + 模块化指南 docs/jdcredvip-modulos.md
jdtalk/ – 通信和人工智能平台
团队使用的全堆应用程序（React + Express + Drizzle ORM）用于人工智能服务和自动化。 jdtalk/jdtalk-main/:
client/：前端em React/Vite。server/Node/Express 后端，带有 WebSocket 和集成。agent-runtime/Codex 代理（Supabase Realtime + OpenAI），可自动分析 INSS 摘录。shared/共享模式和类型（Zod/Drizzle）。
文档 ： jdtalk/jdtalk-main/README.md
可用的集成
- 克雷法兹:
POST /integracoes/crefaz/simular,POST /integracoes/crefaz/contratar,GET /integracoes/crefaz/propostas - Nexxo公司:
POST /integracoes/nexxo/sync,GET /integracoes/nexxo/contratos,GET /integracoes/nexxo/comissoes,GET /integracoes/status
工作流程
- 安装
- 后端： cd jdcredvip-mcp && npm install - 前端： cd jdtalk/jdtalk-main && npm install - 也可以使用 package.json 根 ： npm run install:all
- 执行
- 后端： npm --prefix jdcredvip-mcp run start （标准端口8080，见 .env.example). - 前端/代理： npm --prefix jdtalk/jdtalk-main run dev （或在 JDTalk README 中描述的脚本）。
- 环境变量
- 没有版本 .env每个项目带来一个 .env.example 需要填写的东西。 - 秘密（Google，OpenAI，Hostinger等）只能在部署面板或秘密保险箱中注册。
- 部署
- Hostinger（后端）：将运行目录指向 jdcredvip-mcp/，骑马 npm install e npm start. - 前端：管理快速构建并发布到所选服务（Supabase，Vercel等）。 - QA/Postman：配置生产主机环境以验证端点。 - 详细指南 ： docs/deploy-hostinger.md
附加文件
- 端点清单：
docs/jdcredvip-endpoints-checklist.md - 继承/辅助材料：
docs/legacy/ - 可观察性：活动日志保持在
activity_logs（见下文）。 - 报告导入：请参阅端点 /import/upload、/import/analyze 和 /import/historico。
可观察性和日志
- 后端处理的每个要求都会生成一个记录
activity_logs包括路由、方法、HTTP状态、用户（当经过身份验证时）、源（前端、Postman、API）和有效负载的清洁摘要。 - 记录可以直接在银行查询（
SELECT * FROM activity_logs ORDER BY created_at DESC LIMIT 50;或导出到BI。 - 敏感字段（密码，令牌，秘密等）被自动掩盖，并且大量负载被截断以保持银行平稳。
- 在执行服务之前，请使用此历史记录调试前端操作（例如客户端创建、筛选、导入 ） 。
约定与 Git
- 敏感文件（电子表格、操作 CSV、内部 PDF、JSON 密钥）仍然存在于仓库之外。
- 哦
.gitignore涵盖 dist、缓存、秘密和开发过程中生成的临时目录。 - 对于组合命令，有
package.jsonna raiz（例如：npm run start:backend,npm run dev:frontend).
下一步
- 按照 Hostinger/Supabase 中的指南配置环境变量
docs/deploy-hostinger.md. - 使用 Postman 与新令牌一起验证生产中的端点。
- 可选：在完成重要的 monorepo 里程碑时创建标签或版本。
我们走！ ？？？