📄️ core-auth-service
The authentication and authorization backbone of the CROW platform. Manages user sessions via Better Auth, issues JWTs for internal service communication, handles API key lifecycle, and orchestrates the multi-step onboarding flow.
📄️ core-user-service
Manages internal user records. Each user in this service maps to a Better Auth user via betterAuthUserId and belongs to exactly one organization. Provides user CRUD, profile management, permissions, search, and the builder pattern for onboarding.
📄️ core-organization-service
Manages internal organization records and AI-generated organization context. Each organization maps to a Better Auth organization via betterAuthOrgId. Provides org CRUD, member listing (via user service proxy), and async context generation using Workers AI.
📄️ core-product-service
Manages the product catalog for each organization. Handles product CRUD, web crawling via Cloudflare Browser Rendering, AI-powered product extraction from HTML, image analysis and storage in R2, and semantic search via Vectorize embeddings.
📄️ core-interaction-service
Processes incoming interaction data from all channels (web, CCTV, social). Stores structured interaction records with AI-generated summaries, product associations, and confidence scores. Uses Workers Containers with Durable Objects for CCTV batch analysis.
📄️ core-pattern-service
Discovers behavioral patterns across interactions using a Python CrewAI multi-agent system running in Workers Containers. Triggered by cron schedules for daily, weekly, monthly, and yearly analysis periods. The TypeScript worker manages cron scheduling and D1 storage while the Python container performs the actual AI analysis.
📄️ core-billing-service
Handles Stripe integration for checkout sessions, subscription management, and billing builders used during onboarding. Receives Stripe webhooks for payment event processing.
📄️ core-notification-service
Sends transactional emails via Resend and manages notification queues. Used by other services (auth, billing) to deliver team invitations, payment confirmations, and system notifications.
📄️ core-api-gateway
The single entry point for all client requests. Handles routing, authentication, organization resolution, rate limiting, caching, and security headers. Injects the X-Internal-Key and X-Organization-Id headers that downstream services rely on for trust and authorization.
📄️ bff-chat-service
Backend for Frontend service powering the dashboard chat interface. Implements a CrewAI multi-agent system running in Workers Containers for AI-powered conversational access to all platform data. The TypeScript worker handles HTTP routing, chat history, and asset storage while the Python container handles tool-calling and reasoning.
📄️ core-chat-service
Lightweight chat service implementing a multi-agent system with tool calling using Workers AI. Provides chat session management, message history via D1, and an agentic loop that can search products, query interactions, and retrieve patterns. Also exposes A2A (Agent-to-Agent) protocol endpoints and an agent card.
📄️ core-analytics-service
Tracks usage events for billing and analytics. Stores event records scoped to organizations with event type classification and optional metadata.
📄️ cctv-ingest-service
Handles CCTV video frame ingestion and real-time analysis. Uses Durable Objects (IngestSession) to manage session state and Workers AI (@cf/google/gemma-3-12b-it) for multimodal frame analysis. Dispatches analyzed frame batches to the interaction service via queues.
📄️ mcp-service
Model Context Protocol (MCP) server enabling external LLM integrations (Claude Desktop, ChatGPT, developer tools) to access CROW product, interaction, pattern, and organization data via standardized tool calls. Implements the MCP specification with Streamable HTTP transport over JSON-RPC 2.0.
📄️ a2a-service
Agent-to-Agent (A2A) protocol service implementing Google's A2A specification (v0.3.0). Provides a discoverable agent card and a JSON-RPC endpoint that proxies chat requests to the BFF chat service, enabling external AI agents to interact with CROW's analytics engine.
📄️ bff-qna-service
RAG-based Q&A service for the dashboard. Uses Vectorize for document embeddings and Workers AI for answer generation. Includes a cron job that re-indexes documentation every 12 hours.
📄️ web-ingest-service
Backend for the CROW JavaScript tracking SDK. Receives interaction events from web, mobile (React Native), and desktop (Electron) applications. Uses Durable Objects (CrowWebSession) for session buffering and replay chunk management. Dispatches processed interactions to the interaction service via queues.
📄️ dashboard-client
Next.js dashboard SPA deployed on Cloudflare via OpenNext. The primary interface for CROW users to view interactions, patterns, products, analytics, chat with the AI, and manage their organization.
📄️ auth-client
Next.js authentication pages deployed on Cloudflare via OpenNext. Handles sign-up, sign-in, password reset, and the multi-step onboarding flow. Sets the session cookie on .crowai.dev for cross-subdomain authentication.
📄️ core-social-collector
Social media collection service that gathers mentions, reviews, and brand-related content from social platforms. Runs on a cron schedule (every 2 hours) and supports manual triggering. Collected items are dispatched to a Queue for downstream processing by the social processor.
📄️ landing-client
Astro marketing site and landing pages deployed on Cloudflare Workers via the Astro Cloudflare adapter. The public-facing website for the CROW platform.
📄️ cctv-cli
Node.js command-line tool for capturing and streaming CCTV video frames to the CROW platform. Runs on-premise alongside CCTV cameras and sends frames to the cctv-ingest-service for AI analysis.
📄️ core-social-processor
Queue-driven social content processor that enriches raw social media items with AI-generated sentiment analysis, topic extraction, entity recognition, and summaries. Consumes messages from the social processing queue and produces enriched interaction messages to the main interaction queue.
📄️ Infra Crawl Service
Overview
📄️ Rogue Store
Overview