🎥 Maddheshiya Studio

Maddheshiya Studio is a full-stack web platform for managing and offering a wide range of photography, videography, and digital services. It is designed for studio owners and clients to interact via a modern interface with service browsing, media demos, pricing, and order processing.

---

🧾 Project Description

Maddheshiya Studio offers professional media services through an organized online portal. Service providers can upload image, video, and URL-based demos, while customers can explore, choose services, and interact via a clean frontend UI.

🎯 Key Features

• User registration with email verification (JWT + dj-rest-auth + allauth)
• Role-based system for service providers and clients
• Upload & preview of service media (images, videos, links)
• Service categorization (photography, videography, etc.)
• Dynamic pricing & inclusion breakdown
• Admin panel for management
• Full REST API with Django REST Framework
• Next.js/React frontend with responsive UI

---

🏗️ Tech Stack

• Backend: Django, Django REST Framework, PostgreSQL
• Frontend: Next.js (React, TypeScript, Tailwind CSS)
• Auth: JWT, dj-rest-auth, allauth, Google OAuth
• Media: Cloudinary (for image/video hosting)
• Other: React Query, Vercel (deployment)

---

📦 Folder Structure

backend/
  maddheshiyaStudio/   # Django project settings
  services/            # Service models, views, serializers
  store/               # Gear & studio rental models, views
  users/               # Custom user model, registration, auth
frontend/
  src/app/             # Next.js app directory
    components/        # UI components (Navbar, Hero, etc.)
    context/           # React context (Auth)
    lib/               # QueryClient setup
    (services)/        # Service-specific pages
  public/              # Static assets

---

🚀 Getting Started

Backend (Django)

1. Install dependencies:

   cd backend
   pip install -r requirements.txt

2. Configure .env for database and secrets.
3. Run migrations:

   python manage.py migrate

4. Start server:

   python manage.py runserver

Frontend (Next.js)

1. Install dependencies:

   cd frontend
   npm install

2. Configure .env.local for Cloudinary and API URLs.
3. Start development server:

   npm run dev

---

🔗 API Endpoints

• /api/users/register/ — User registration
• /api/users/me/ — Get current user info
• /api/services/ — List all services
• /api/services/<id>/ — Service details
• /api/services/<service_id>/upload/ — Upload media for a service
• /api/store/gear/ — List/rent gear
• /api/store/studio/ — List/rent studios

---

📝 Environment Variables

Backend (backend/.env)

• POSTGRES_DB, POSTGRES_USER, POSTGRES_PASSWORD, DB_HOST, DB_PORT
• GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
• SECRET_KEY, DATABASE_URL, DEBUG

Frontend (frontend/.env.local)

• NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME
• NEXTAUTH_URL

---

👤 Roles

• Creator: Can list services, upload media, manage gear/studio rentals
• Client: Can browse, book, and interact with services

---

📚 License

MIT License

---

✨ Credits

Developed by Maddheshiya Studio Team.

---

🧩 Services Offered

Category	Description
Professional Photography	Wedding, Event, Product Shoots
Videography	Drone, Crane, Cinematic Shots
AI-Powered Editing	AI-driven enhancements
Album Designing	Custom digital and printed albums
Drone Footage	Aerial photography and videography
E-Commerce Photography	Product listings, white background
T-Shirt Printing	Personalized apparel
ID Card Making	Smart and PVC card printing
AI Assistant	Custom AI assistants & automation
Photo Framing	Studio-quality print & frame

---

Local Setup

git clone https://github.com/yourusername/maddheshiya-studio.git


### Backend Setup

cd backend
poetry install
poetry shelll
python manage.py makemigrations
python manage.py runserver


### Frontend Setup
cd frontend
npm install
npm run dev

---

## 📄 License

This project is licensed under the [MIT License](./LICENSE).