工作流自动化系统

前景管道

Prospect Pipeline是一个用于混乱、多系统业务操作的生产式工作流自动化系统。它将Raycast命令、本地FastAPI桥、传统的Laravel仪表板工作流程、Supabase报告真相、Next/Vercel表面、审计脚本和人工智能辅助操作员工作流程组合到一个有记录的操作表面中。

该仓库被用作实际人工智能和工作流自动化工作的公共证明。它展示了脆弱的手动流程如何转化为可重复的命令、真相来源合同、验证测试和变异前审查工作流，而无需盲目地将业务决策交给自动化。

这表明了什么

• 用于日常操作员工作流的Raycast命令界面，包括搜索、任务处理、会议支持、客户端消息传递、视频工作流工具和报告实用程序。
• 本地FastAPI桥，将传统的Laravel仪表板行为调整为稳定的本地API表面。
• 在约会、生命周期事件、通话记录、确认支持和相关报告表中提供真相清理来源。
• 在清理或迁移工作之前，将预期的工作流真实性与源系统进行比较的审计和奇偶校验脚本。
• 重点测试和架构合同，随着命令的发展保护业务意义。
• Prospect Web和Vercel表面用于公共安全报告、可视化地图和工作流支持页面。
• 人工智能辅助起草、分类和支持工作流程，专为操作员审查而非盲目自动化而设计。

建筑

支持的运行时路径为：

Raycast commands -> local FastAPI bridge -> legacy Laravel dashboard
                              |
                              v
                  Supabase durable reporting truth
                              |
                              v
               Prospect Web / Vercel support surfaces

中的Raycast命令 src/ 在中调用本地FastAPI服务 npid-api-layer/.FastAPI将本地请求转换为源系统期望的遗留仪表板表单和响应。Supabase存储持久的工作流事实，其中仓库具有明确的变异权限。Prospect Web读取批准的报告/支持表面，但它不具有生命周期意义。

真理的来源边界

回购协议有意严格限制所有权：

• 命令是UI表面，而不是业务真相。
• 域模块具有工作流含义。
• Laravel/FastAPI调用是源系统适配器。
• Supabase在源系统操作成功后或在明确的审计/修复工作流后存储持久真理。
• 人工智能助手起草、分类、总结和提出行动以供审查；它们不会悄无声息地改变真理之源的状态。

核心示例：

• appointments 拥有持久的会议时间、时区、侦察、活动标识、重新安排链和会后结果事实。
• lifecycle_events 通过规范生命周期编写器拥有销售阶段生命周期历史。
• call_log 是呼叫活动、会议事实、会后结果和注册/付款证据的集中报告分类账。
• set_meeting_confirmation_cache 支持确认消息工作流；这不是生命周期的真理。
• 联系人缓存表面支持查找和消息接纳；他们不知道会议的真相。

看 侦察协调员系统图 和 童子军准备Supabase真理之源 对于完整的合同。

主表面

• src/ -光线投射命令、域模块、命令UI和本地工作流帮助程序。
• npid-api-layer/ -用于传统仪表板支持的工作流的本地FastAPI桥。
• scripts/ -审计、修复、同步、验证和报告实用程序。
• supabase/ -持久工作流/报告表的架构和迁移历史。
• apps/prospect-web/ -Next/Vercel支撑表面。
• docs/architecture/ -真相来源规则、系统图、工作流边界和清理合同。
• docs/visual-maps/ -面向操作员的可视化地图，用于工作流程对齐。

代表性命令

• Scout Prep
• Client Messages
• Set Meetings
• Scout Openings
• Prospect Search
• Assign Video Team Inbox
• Read Video Team Inbox
• Video Updates
• Video Progress
• Daily Call Blocks

设置

安装JavaScript依赖项：

npm ci

设置FastAPI桥：

cd npid-api-layer
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cd ..

本地运行

启动FastAPI桥：

npm run api

启动Raycast扩展：

npm run dev

一起开始：

npm run dev:all

推荐的监督工作流程：

npm run dev:stack:install
npm run dev:stack

要在路由器更改后仅重新启动FastAPI，请执行以下操作：

npm run dev:api:restart

有关完整的命令集，请参见 开发过程.

配置

此仓库希望本地凭据和会话不参与公共提交。

• 本地环境文件，如 .env, .env.local，以及 .overmind.env 被忽略。
• 仪表板支持的命令依赖于仓库外的私有本地会话文件。
• 必须通过本地环境变量或平台管理的机密提供Supabase、仪表板、Vercel、电子邮件和通知凭据。
• 公共工件应使用基于角色的标签和合成示例，而不是真实的客户、运动员、家长、员工或公司内部详细信息。

证明与验证

有用的确定性检查：

npm run test:domain
npm test
npm run build
git diff --check

对狭窄的工作流程更改使用集中测试。在接触共享的Scout Prep、生命周期、Supabase、报告、预约或客户端消息行为时，使用广泛的测试。本地测试仅证明确定性回购行为；实时仪表板、Supabase、Vercel、Raycast和浏览器状态需要单独的实时回读。

公共安全案例研究指针

强大的公共案例研究表面：

• 侦察协调员系统图
• 童子军准备Supabase真理之源
• Supabase洁净室真相图
• 童子军预备域合同
• Prospect虚拟主机适配器
• 传统分配调试模板
• scripts/audit-supabase-truth-map.mjs
• scripts/audit-call-tracker-live-parity.mjs
• scripts/audit-raycast-workflow-identity-contract.mjs
• scripts/watch-ended-meeting-outcomes.mjs
• src/domain/workflow-context.ts
• src/lib/supabase-lifecycle.ts