plasma-dealbox System Requirements Document

1. Introduction

plasma-dealbox is a lightweight deal-management and invoicing application designed specifically for nano and micro creators (1K–100K followers) in India. It addresses the common issue of managing brand collaborations that often get lost in WhatsApp chats and mental notes. Unlike existing platforms that focus on brands managing creators, plasma-dealbox is creator-centric, enabling creators to track interactions, promises, deliveries, and payments efficiently.

2. System Overview

plasma-dealbox is built as a Jetpack Compose Android app with a thin web layer for the public rate-card page. It leverages Firebase/Firestore for backend services, the Gemini API for message parsing, and Razorpay for UPI-native invoicing. The app's core functionality revolves around a Kanban pipeline workflow and AI-assisted intake features to streamline deal management for creators.

2a. Source Content Inventory

• Gemini API: Used for message parsing to extract brand name, deliverable, deadline, and quoted amount.
• Razorpay: Integrated for UPI-native invoicing.
• Firebase/Firestore: Backend services for data storage and management.

3. Functional Requirements as Story Points

• As a Creator, I should be able to paste a brand's WhatsApp message and have the app automatically extract relevant deal details using the Gemini API.
• As a Creator, I should be able to track my deals through a Kanban pipeline: Inquiry → Negotiating → Confirmed → Delivered → Paid.
• As a Creator, I should be able to generate and send invoices automatically once a deal is marked as delivered.
• As a Creator, I should receive automated payment reminders if a payment is overdue.
• As a Creator, I should be able to create a shareable rate-card page to simplify sharing my rates with brands.
• As a Creator, I should be able to access basic analytics on payment speed and best-performing deal types.
• As a User, I should be able to manage up to 3 active deals for free, with options to upgrade for more features.

4. User Personas

• Creator: Nano and micro influencers with 1K–100K followers, managing brand collaborations and invoicing.
• Brand Representative: Individuals or teams from brands interacting with creators for collaborations.

5. Core User Flows

• Creator receives a brand message on WhatsApp → Pastes message into the app → Gemini API extracts deal details → Deal card is created in the Kanban pipeline.
• Creator progresses deal through Kanban stages → Marks deal as delivered → App generates invoice → Sends automated payment reminder if necessary.
• Creator sets up a rate-card page → Shares link with brands → Brands access pricing information directly.

6. Visuals Colors and Theme

• primary: #FF5722 (a vibrant orange reflecting creativity and energy)
• primary_light: #FF8A50 (a lighter tint for hover states)
• secondary: #FFC107 (a warm yellow for supportive elements)
• accent: #4CAF50 (a green for CTAs and active states)
• highlight: #03A9F4 (a blue for notifications and hover states)
• bg: #FFFFFF (a clean white background)
• surface: #F5F5F5 (a light grey for cards and panels)
• text: #212121 (a dark grey for primary text)
• text_muted: #757575 (a softer grey for secondary text)
• border: #E0E0E0 (a subtle grey for borders)

7. Signature Design Concept

The plasma-dealbox app will feature an interactive Kanban board on the home page, where deal cards can be dragged and dropped between stages. Each card will animate with a smooth transition, flipping to reveal more details on hover. The background will feature a dynamic, abstract pattern that subtly shifts colors based on the time of day, creating a living, breathing interface. This concept will be implemented using motion/react for animations and transitions.

LANDING HERO MOTION BRIEF

The landing page will feature a continuous animation loop where a creator's journey is visualized: a message icon transforms into a deal card, which then moves through the Kanban stages, finally turning into an invoice icon. This animation will be built using CSS and motion/react, ensuring a smooth and engaging experience that highlights the app's core functionality.

8. Interaction Model & Motion Direction

• Interaction Model: Animated
• The landing page will feature moderate scroll-triggered reveals and hover transitions, with spring physics applied to interactive elements. This approach will provide a polished and engaging user experience, emphasizing the app's dynamic nature.

9. Non-Functional Requirements

• The app must be responsive and perform well on various Android devices.
• Data security and privacy must be ensured, particularly concerning financial transactions and personal information.

10. Tech Stack

• Frontend: Jetpack Compose for Android
• Backend: Firebase/Firestore
• APIs: Gemini API for message parsing, Razorpay for invoicing

11. Assumptions and Constraints

• The app is primarily targeted at the Indian market, with pricing and features tailored to local creators.
• The app will support UPI payments through Razorpay, assuming users have access to UPI-enabled bank accounts.

12. Glossary

• Kanban Pipeline: A visual workflow management method used to track progress through different stages.
• Gemini API: An API used for extracting structured data from unstructured text.
• Razorpay: A payment gateway service that supports UPI transactions.
• UPI: Unified Payments Interface, a real-time payment system in India.