System Requirements Document for bright-field

1. Introduction

The "bright-field" project aims to address the challenges faced by service businesses in collecting and displaying social proof. The project targets freelancers, SaaS founders, coaches, agencies, and consultants, providing them with tools to efficiently gather testimonials and leverage them for conversion.

2. System Overview

The bright-field project will provide a platform that automates the collection and display of testimonials. It will integrate AI features to enhance the testimonial collection process and provide a seamless user experience for both the service providers and their clients.

2a. Source Content Inventory

• AI Features: AI-generated testimonial request emails, sentiment analysis of submitted text, auto-video transcription.
• MVP Features: Branded collection link, text/video capture, embeddable wall widget, email automation.

3. Functional Requirements as Story Points

• As a Freelancer, I should be able to generate AI-powered testimonial request emails to streamline the process.
• As a SaaS Founder, I should be able to analyze the sentiment of submitted testimonials to gauge customer satisfaction.
• As a Coach, I should be able to transcribe video testimonials automatically to save time.
• As an Agency, I should be able to create a branded collection link for gathering testimonials.
• As a Consultant, I should be able to capture text and video testimonials easily.
• As a User, I should be able to embed a testimonial wall widget on my website.
• As a User, I should be able to automate email requests for testimonials.

4. User Personas

• Freelancer: Independent professionals who need to showcase their work and client satisfaction.
• SaaS Founder: Entrepreneurs running software-as-a-service businesses looking to build trust with potential customers.
• Coach: Professionals offering guidance and training who require testimonials to validate their expertise.
• Agency: Companies providing services to multiple clients, needing a streamlined process for collecting feedback.
• Consultant: Experts offering advice and solutions, who benefit from client testimonials to enhance credibility.

5. Core User Flows

• Freelancer sends AI-generated testimonial request email -> Client submits testimonial -> Sentiment analysis is performed -> Testimonial is displayed on the wall widget.
• SaaS Founder creates branded collection link -> Shares link with customers -> Customers submit text/video testimonials -> Testimonials are transcribed and analyzed.
• Coach automates email requests -> Receives video testimonials -> Auto-transcription is performed -> Testimonials are embedded on the website.

6. Visuals Colors and Theme

• primary: #1E90FF (Dodger Blue)
• primary_light: #63B8FF (Light Dodger Blue)
• secondary: #FFD700 (Gold)
• accent: #FF4500 (Orange Red)
• highlight: #32CD32 (Lime Green)
• bg: #F5F5F5 (White Smoke)
• surface: #FFFFFF (White)
• text: #333333 (Dark Gray)
• text_muted: #777777 (Gray)
• border: #DDDDDD (Light Gray)

7. Signature Design Concept

Interactive Testimonial Galaxy

The homepage will feature an interactive galaxy map where each star represents a testimonial. Users can click on a star to open a detailed view of the testimonial, drag to rotate the galaxy, and hover to highlight connections between testimonials. This concept will be built using @react-three/fiber and @react-three/drei for a 3D experience.

LANDING HERO MOTION BRIEF

The landing page will feature a dynamic illustration of testimonials orbiting around a central "bright-field" logo. As users scroll, the testimonials will animate towards the center, symbolizing the collection process. The animation will loop every 10 seconds, showing testimonials transforming into a cohesive wall of social proof. This will be achieved using motion/react for smooth transitions and interactions.

8. Interaction Model & Motion Direction

• Interaction Model: Parallax
• The landing page will utilize layered depth via scroll, with testimonials and decorative elements translating at different speeds to create a visually rich first impression.
• Internal pages will maintain a "static" interaction model for clarity and ease of use.

9. Non-Functional Requirements

• The system must handle high volumes of testimonial submissions without performance degradation.
• The platform should ensure data privacy and secure storage of testimonials.
• The user interface must be responsive and accessible across all devices.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses, Claude Sonnet 5 for academic or coding work, Google Nano banana for image generation
• AI Tools: Litellm for LLM Routing, Langchain
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

11. Assumptions and Constraints

• The platform will primarily target indie SaaS founders and Notion template sellers initially.
• Pricing will be set between $10–$25/month to remain competitive.
• Growth will be driven through channels like Indie Hackers, Product Hunt, and SaaS founder newsletters.

12. Glossary

• MRR: Monthly Recurring Revenue
• AI: Artificial Intelligence
• SaaS: Software as a Service
• MVP: Minimum Viable Product
• CTA: Call to Action

This document outlines the comprehensive system requirements for the bright-field project, ensuring alignment with user needs and market opportunities.