#3 Self-approved and unit tests passed with flying colors. Co-authored-by: Sagnik <sagnik7896@gmail.com> Reviewed-on: sagnik/Project_Velocity#5
8.0 KiB
Project Title: Project Velocity
The Immersive Sales Suite
Sprint 1
Project Description:
Project Velocity is an integrated AI-powered real estate sales ecosystem designed for high-tier brokerages. The suite encompasses edge-computing hardware ("Black Box"), automated visual generation pipelines via ComfyUI ("The Catalyst"), a robust FastAPI-based neural core, and an immersive Swift-based iPad application ("Immersive Sales Companion"). The system manages the entire lead lifecycle: from autonomous engagement and lead qualification via WhatsApp/Email bots ("The Oracle"), to real-time sentiment analysis, automated ad bidding, and on-the-fly marketing asset generation.
EPIC 1: Architecture, Visual AI & Prompt Engineering (Assignee: Sagnik)
User Story 1.1: As an Architect, I need to configure the local and cloud hardware environments so the team can build without bottlenecks.
UX: 0
Design: 0
Front: 0
Back: 8
Total Points: 8
Tasks:
- W1: Define the local "Black Box" edge server requirements for the offline-first experience center setup.
- W2: Provision the AWS 8xA100 instance.
- W2: Configure virtualization to split the AWS instance into two compute nodes: Node 1 (Sourik's Agent/Bot Operations) and Node 2 (Sagnik & Sayan's Model/Render Operations).
- W2: Set up secure SSH tunnels networks to allow remote access to the AWS nodes.
User Story 1.2: As an AI Visual Artist, I need to create API-ready ComfyUI workflows for "The Catalyst" and the "Immersive Sales Companion".
UX: 0
Design: 3
Front: 2
Back: 3
Total Points: 8
Tasks:
- W1: Build the "Dream Weaver" interior restyling workflow using ControlNet + segment masking to preserve room geometry while changing aesthetics.
- W1: Build a marketing poster generation workflow using Qwen-Image 2512 to leverage its advanced multilingual text rendering capabilities for precise real estate typography.
- W2: Implement the Wan 2.2 (14B or 1.3B) video generation workflow for cinematic promotional videos.
- W2: Expose all ComfyUI workflows via the Asynchronous Queue API so Sourik's agents can trigger them automatically.
User Story 1.3: As an AI Engineer, I need to generate system prompts and fine-tune models so "The Oracle" and "The Catalyst" behave like elite real estate professionals.
UX: 2
Design: 3
Front: 3
Back: 0
Total Points: 8
Tasks:
- W1: Draft "The Oracle" persona prompts (adapting the tone of top-tier Dubai brokers) for the WhatsApp CRM agent.
- W1: Create marketing strategy prompts for "The Catalyst" to generate Meta/Google ad copy based on demographic inputs.
- W1: Lock the frontend UI design (the "Apple/Steve Jobs" aesthetic) and officially hand over the React components and required API schemas to Sayan for backend wiring.
EPIC 2: Full-Stack Integration, CRM & iOS App (Assignee: Sayan)
User Story 2.1: As an iOS Developer, I need to build the "Immersive Sales Companion" iPad App using Swift.
UX: 3
Design: 2
Front: 3
Back: 0
Total Points: 8
Tasks:
- W1: Build the native SwiftUI app shell mirroring the WebOS interface (Dashboard, Inventory, Oracle tabs).
- W1: Implement the camera capture feature to take photos of empty walls/rooms and push them to Sagnik's ComfyUI API endpoint.
- W1: Integrate ARKit/CoreLocation/CoreMotion to overlay the mathematical Sun Path over the live camera feed or 3D model view.
User Story 2.2: As a Backend Engineer, I need to build the FastAPI neural core to connect all 4 software components.
UX: 0
Design: 0
Front: 0
Back: 8
Total Points: 8
Tasks:
- W1: Set up the Marketing page frontend for Sourik.
- W1: Set up the Python FastAPI server with a PostgreSQL/Supabase database.
- W1: Create API endpoints for "The Oracle" (/api/leads, /api/chat-logs) to receive data from Sourik's WhatsApp bots.
- W1: Create API endpoints for "The Sentinel" (/api/biometrics, /api/sentiment) to ingest video player facial/voice data points.
- W1: Set up WebSockets to stream real-time updates directly to the WebOS React frontend.
User Story 2.3: As a Full-Stack Engineer, I need to build the "Walled Garden" CRM and wire the React WebOS.
UX: 2
Design: 0
Front: 3
Back: 3
Total Points: 8
Tasks:
- W2: Connect the frontend React components to the FastAPI endpoints.
- W2: Develop the logic for the simplified "Kanban" CRM pipeline, ensuring lead stages automatically update based on triggers from "The Oracle".
- W2: Ensure the WebOS dashboard accurately visualizes the parsed AI sentiment data’s output.
EPIC 3: Agentic Framework, Automation & Ad Network (Assignee: Sourik)
User Story 3.1: As an Automation Engineer, I need to deploy and manage the Claw bot ecosystem for "The Oracle".
UX: 0
Design: 0
Front: 0
Back: 5
Total Points: 5
Tasks:
- W1: Deploy PicoClaw or IronClaw to act as the primary communication agent.
- W1: Connect the bot to WhatsApp/Email APIs to ingest client messages.
- W1: Configure DM pairing and security allowlists.
- W1: Route all parsed chat transcripts, call durations, and interaction logs directly into Sayan's CRM database via FastAPI webhooks.
User Story 3.2: As an AI Operator, I need to set up the MCP Server and Agent System Tools.
UX: 0
Design: 0
Front: 0
Back: 5
Total Points: 5
Tasks:
- W1: Set up the Model Context Protocol (MCP) server for secure access to local files, the property database, and the internet.
- W1: Configure HEARTBEAT.md or Cron tools for periodic background tasks.
- W1: Configure Brave Search API to allow the agent to autonomously research target audiences.
User Story 3.3: As a Marketing Automation Lead, I need to build "The Catalyst" integration.
UX: 2
Design: 1
Front: 2
Back: 3
Total Points: 8
Tasks:
- W2: Integrate Meta Business API and Google AdWords API as agent "Skills".
- W2: Give the agent the ability to read ad insights, manage marketing budgets, and execute automated bidding strategies.
- W2: Write the bridging script allowing the agent to autonomously prompt Sagnik's ComfyUI API to generate custom posters and promotional videos.
- W2: Configure the headless browser tool or social APIs for autonomous content posting.
EPIC 4: Immersive Reality & Buyer Intelligence (Phase 2)
Focus: Cinematic AI life simulation, interactive AR environments, biometric engagement tracking, and wealth projections.
User Story 4.1: As an AI Visual Artist and iOS Developer, we need to build the "Future Life" and "Time & Light" engines to emotionally anchor the buyer to the property.
UX: 5
Design: 5
Front: 5
Back: 8
Total Points: 23
Assignees: Sagnik & Sayan
Tasks:
- [ ] Phase 2: (Sagnik) Build a ComfyUI/Wan 2.2 workflow for "Future Life Simulation" that generates cinematic videos of specific lifestyle prompts (morning sunlight, kids playing, dinner parties) mapped to the unit's floorplan.
- [ ] Phase 2: (Sayan) Integrate a "Time & Light Engine" into the Swift iPad app using ARKit/SceneKit to simulate real-time sun paths, seasonal shadows, and weather changes (rain, festive lighting) over the 3D model.
- [ ] Phase 2: (Sayan) Add interactive touchscreen sliders to the iPad app to control month, time of day, and view obstruction massing.
User Story 4.2: As a Full-Stack Engineer and Automation Lead, we need to build the Engagement Intelligence and Social Proof layer to give the sales team data-driven closing tools.
UX: 3
Design: 3
Front: 5
Back: 8
Total Points: 19
Assignees: Sayan & Sourik
Tasks:
- [ ] Phase 2: (Sayan) Build the "Legacy Mode" wealth projection UI in the iPad app and WebOS, visualizing 10-20 year compounding appreciation and rental yields against gold/stock benchmarks.
- [ ] Phase 2: (Sayan) Create the "Social Proof" live map in the frontend, dynamically clustering anonymized buyer demographics (NRI vs local, professions) to build tribe psychology.
- [ ] Phase 2: (Sourik) Configure "The Sentinel" backend API to ingest and process eye-tracking and micro-expression data from the iPad's front-facing camera (with consent) during the tour.
- [ ] Phase 2: (Sayan) Update the WebOS CRM dashboard to visualize the emotional spike data, highlighting exactly which rooms peaked the buyer's interest for post-tour sales anchoring.