PetSphere

PetSphere is a web application combining social media interactions with a pet marketplace. Designed for pet enthusiasts, the platform enables users to share posts, publish pet listings, communicate via real-time WebSocket chat and WebRTC video calling, and interact within a dedicated community.

---

Tech Stack

Frontend (/Client)

• Core: React 18, React Router v6
• State Management: Redux Toolkit, Redux Persist
• Styling: Tailwind CSS
• Real-time & Video: WebSockets, WebRTC (simple-peer), Agora RTC SDK
• Maps & Location: Mapbox GL JS (react-map-gl)

Backend (/Server)

• Core: Django 5.1, Django REST Framework (DRF)
• Real-time Engine: Django Channels (ASGI via Daphne)
• Database: PostgreSQL 13
• Task Queue & Caching: Redis 7, Celery, Celery Beat
• Integrations: AWS S3, Stripe Payments, Twilio SMS, Google OAuth2

---

Quick-Start Guide

Prerequisites

• Python 3.10+
• Node.js 18+
• PostgreSQL 13+
• Redis 7+
• Docker & Docker Compose (optional)

---

Option 1: Local Development

1. Backend Setup (/Server)

cd Server
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
python manage.py migrate
daphne -b 127.0.0.1 -p 8000 petsphere.asgi:application

2. Frontend Setup (/Client)

cd Client
npm install
npm run dev

---

Option 2: Docker Setup

Run all backend services (Django ASGI server, PostgreSQL database, Redis cache, Celery worker, Celery beat) simultaneously:

cd Server
docker-compose up --build

---

Repository Layout

petsphere/
├── Client/       # React SPA (Pages, UI components, Redux store)
├── Server/       # Django REST API & ASGI WebSockets (Apps, models, tasks)
└── .github/      # CI/CD GitHub Actions workflows

For complete technical specifications, database model schemas, API endpoints, and system architecture details, see AI_MANIFEST.md.