Files
Project_Velocity/.Agent Context/Sprint 1/Project Velocity_ User Stories and Task Breakdown Sprint 1.md
sagnik 55bb5e5a90 feat: Build the Dream Weaver interior restyling workflow to preserve room geometry while changing aesthetics (#5)
#3 Self-approved and unit tests passed with flying colors.

Co-authored-by: Sagnik <sagnik7896@gmail.com>
Reviewed-on: #5
2026-03-10 01:36:27 +05:30

8.0 KiB
Raw Blame History

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 datas 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.