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

229 lines
8.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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.