chore: condense all docs and markdown files

README.md

@@ -1,67 +1,31 @@
-# Salon Booking Platform
+# Salon
 
-Scaffolded Django + React starter for a salon booking platform.
+KSA-first salon booking platform.
 
-## Backend
+## Quick start
 
-Location: `backend/`
+### 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`
 
-### Setup
+Optional demo data:
+- `python3 manage.py seed_demo`
 
-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.
+Backend tests:
+- `cd backend && python3 -m pytest`
+- external integrations only: `PYTEST_ADDOPTS='' python3 -m pytest -m external`
 
-### Demo data
+### Frontend
+1. `cd frontend && npm install`
+2. `npm run dev`
+3. tests: `npm run test`
 
-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`
+## 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`