# Salon

KSA-first salon booking platform.

## Quick start

### Backend
1. `python3 -m venv venv && source venv/bin/activate`
2. `pip install -r backend/requirements.txt -r backend/requirements-dev.txt`
3. `cp backend/.env.example backend/.env`
4. `cd backend && python3 manage.py migrate && python3 manage.py runserver`

Optional demo data:
- `python3 manage.py seed_demo`

Backend tests:
- `cd backend && python3 -m pytest`
- external integrations only: `PYTEST_ADDOPTS='' python3 -m pytest -m external`

### Frontend
1. `cd frontend && npm install`
2. `npm run dev`
3. tests: `npm run test`

## Docs map
- Agent rules: `AGENTS.md`
- Docs index: `docs/README.md`
- Plans/ExecPlan policy: `docs/PLANS.md`
- Active ExecPlan: `docs/execplans/auth-phone-first-hardening.md`
- Architecture: `docs/architecture.md`
- Risks: `docs/risks.md`