Welcome to the central repository for SocialApp (HoloMedia). This document serves as the combined Product Requirements Document (PRD) and Business Infrastructure Specification for our multi-platform social ecosystem.
SocialApp (HoloMedia) is a modern social media platform designed for interactive content creation, real-time messaging, and collaborative community building. The platform empowers users to share rich media, express sentiment with nuanced reactions, form community groups, and communicate instantly through highly interactive direct messaging.
The mission of HoloMedia is to bridge the gap between web and mobile user experiences, offering a fast, responsive, and engaging social graph.
- The Content Creator: Publishes text, video, and audio; tracks engagement (reposts, likes, bookmarks); values seamless media uploading.
- The Community Builder: Creates and moderates niche Groups; seeks high-engagement feeds; organizes group-specific dialogue.
- The Active Engager: Consistently interacts via reactions, comment threads, direct messaging, and sharing/reposting content.
- The System Administrator: Oversees platform health, manages community moderation, suspends bad actors, and controls operational modes (e.g., Maintenance Mode).
- Registration & Login: Secure sign-up/login mechanisms utilizing secure password hashing on the server and issuing JWT tokens.
- User Profiles: Custom bio, dynamic user colors, avatar selection, and public statistics (post count, followers, following counts).
- Following System: Ability to follow/unfollow other users, dynamically updating the feed and social graph.
- Post Composition: Support for text content, custom images, video attachments, and integrated Spotify soundtracks.
- Interactive Feed: A unified timeline featuring posts, comments, and native share/reposts.
- Bookmarking: Save posts to a private bookmark list for future reference.
- Batch Query Serialization: Feeds must leverage optimized batch database queries to prevent N+1 performance bottlenecks and API request timeouts on heavy traffic feeds.
- Nuanced Reactions: Move beyond the simple "like" button. Support for six distinct reactions:
like,love,haha,wow,sad, andangry. - Comment Threads: Enable users to participate in conversational threads under posts.
- Group Creation: Users can create dedicated Groups with custom descriptions and vibrant theme colors.
- Group Publishing: Group members can target posts directly inside the community wall, visible to all group members.
- Instant Direct Messaging: Fast, bilateral direct messaging leveraging Socket.io WebSockets.
- Read Receipts & Unread Counts: Track whether messages have been viewed by the recipient.
- Real-Time Alerts: Trigger instant socket notifications for critical engagement events: follows, likes/reactions, comments, and direct messages.
- SEO Optimization: Detect search engine crawlers (e.g., Googlebot, Bingbot) and serve optimized static pre-rendered HTML to maximize indexability.
- Sitemap & Robots Control: Generate dynamic sitemaps (
sitemap.xml) to list all posts, users, and groups alongside a customrobots.txtconfiguration.
- Security:
- All passwords stored using secure one-way hashing algorithms (e.g., Werkzeug hashing).
- JWT tokens used for API access control with configurable expiration parameters.
- Route guards on the frontend to protect authenticated user space.
- Performance: High database read optimization; batched requests for bulk serialization.
- Usability: Fully responsive styling, smooth mobile sidebar-to-bottom-navigation transition (for screens under 640px), hidden scrollbars, and customized bottom padding to ensure zero layout overlaps on mobile devices.
To maintain business continuity and operational excellence, the application's roles are structured as follows:
┌────────────────────────────────────────────────────────┐
│ System Administrator │
│ (Moderation, Maintenance Toggle, Accounts Suspension)│
└───────────────────────────┬────────────────────────────┘
▼
┌────────────────────────────────────────────────────────┐
│ Support Team │
│ (User Verification, Post Moderation, Reports) │
└───────────────────────────┬────────────────────────────┘
▼
┌────────────────────────────────────────────────────────┐
│ Standard End-User │
│ (Profiles, Feed Posting, Group Creation, Messaging) │
└────────────────────────────────────────────────────────┘
- System Administrator: Full platform permissions. Can suspend or unsuspend users instantly. Toggles the platform's global Maintenance Mode in emergencies or upgrade windows, returning structured HTTP status responses.
- Support Team: Reviews flag notifications and handles platform policy violations.
- End-User / Creator: Engages with standard platform features.
All business feature validations and engineering improvements are verified locally using a dedicated local sandbox process.
- Local Application Database: Utilizes an embedded SQLite database engine (
holomedia.db) for rapid environment setup, seeding, and verification. - Development Service Ports:
- Frontend: Served on local Web/Preview Server.
- Backend API: Flask Development Server served on port
5000with WebSocket capabilities.
- Python 3.10+ (with virtual environment capability)
- Node.js 22+
- NPM Package Manager
- Enter directory:
cd backend - Create and activate a virtual environment:
python -m venv venv source venv/bin/activate - Install required packages:
pip install -r requirements.txt
- Define environment variables in
.env:SECRET_KEY=holomedia-dev-secret-change-me JWT_SECRET_KEY=holomedia-jwt-secret DATABASE_URL=sqlite:///holomedia.db CORS_ORIGINS=*
- Run application server:
python app.py
- Enter directory:
cd frontend - Install packages:
npm install
- Start local development server:
npm start
- Compile local build:
npm run build
Ensure all product capabilities remain resilient during iteration.
Verify client performance and unit coverage:
cd frontend
npm run test