Salon Booking Platform

Scaffolded Django + React starter for a salon booking platform.

Backend

Location: backend/

Setup

1. Create a virtualenv and install dependencies.
   • python3 -m venv venv && source venv/bin/activate (or venv\Scripts\activate on Windows)
   • pip install -r backend/requirements.txt -r backend/requirements-dev.txt
2. Copy backend/.env.example to backend/.env and adjust values.
3. Run migrations and start the server.

Demo data

After migrations, you can seed demo data:

• python manage.py seed_demo

Tests

• From project root with venv active: venv/bin/python3 -m pytest (run from backend/ so pytest.ini is picked up)
• External provider tests are skipped by default; run explicitly when needed: PYTEST_ADDOPTS='' venv/bin/python3 -m pytest -m external

Core API endpoints (current scaffold)

• POST /api/auth/register/
• POST /api/auth/token/
• POST /api/auth/token/refresh/
• GET/PATCH /api/auth/me/
• POST /api/auth/otp/request/
• POST /api/auth/otp/verify/
• POST /api/auth/phone/request/
• POST /api/auth/phone/verify/
• POST /api/auth/social/<provider>/ (placeholder)
• GET /api/salons/
• GET /api/salons/<id>/
• GET /api/salons/<id>/services/
• GET /api/salons/<id>/staff/
• GET /api/salons/<id>/reviews/
• GET/POST /api/bookings/
• GET /api/bookings/<id>/
• GET/POST /api/payments/

Frontend

Location: frontend/

Setup

1. Install dependencies via npm install.
2. Run npm run dev.

Tests

• npm run test

The dev server proxies /api to http://localhost:8000.

Project Notes

• Known gaps and risks: docs/risks.md
• Architecture and async/observability decisions: docs/architecture.md
• Documentation index and standards: docs/README.md and docs/documentation.md