# TaxiDashboard backend — найденные пути для модуля `mechanic`

Записано по результатам Task A1 (recon существующего кода `c:\NewProject\taxi-dashboard\backend\app\`).

## Корень backend

`/opt/sites/taxi-dashboard/backend/app/` (на VDS)
`c:\NewProject\taxi-dashboard\backend\app\` (локально)

## Импорты для нового модуля `mechanic`

```python
from app.models.base import Base, TimestampMixin       # SQLAlchemy declarative + created_at/updated_at
from app.db import get_db, async_session, engine       # async session factory + dependency
from app.auth.deps import get_current_user             # OAuth2 Bearer JWT
from app.models.user import User                       # User модель
```

## Auth

- **OAuth2 Password Flow + Bearer JWT** (не PIN, как я ошибочно писал в спеке).
- Логин: `POST /v1/auth/login` (или похожий, нужно найти в `app/api/auth.py`) с form-data `username` + `password` → возвращает `{ "access_token": "...", "token_type": "bearer" }`.
- Дальнейшие запросы: header `Authorization: Bearer <token>`.

## Naming clash + решение

В TaxiDashboard уже есть модуль `app.api.inspections` (читает данные **CarInspection**, импортированные от вендора NaughtySoft через VendorBridge) под префиксом `/v2/inspections`.

Чтобы не конфликтовать:
- Наш новый модуль: `app/api/mechanic.py` (или `app/mechanic/router.py` как подмодуль) — префикс `/api/v1/mechanic`
- Наши новые таблицы:
  - `mechanic_inspections` (наша запись осмотров через PWA)
  - `mechanic_inspection_photos`
  - `mechanic_damage_markers`
- Наши новые модели:
  - `app/models/mechanic_inspection.py` — `MechanicInspection`
  - `app/models/mechanic_inspection_photo.py` — `MechanicInspectionPhoto`
  - `app/models/mechanic_damage_marker.py` — `MechanicDamageMarker`

Существующие `CarInspection`, `car_inspections`, `inspection_failed_photo` — **не трогаем**. Они продолжают жить read-only от VendorBridge.

## Существующий стек

- Python 3.x + FastAPI + SQLAlchemy 2.x async
- PostgreSQL (видна migration via Alembic — папку проверим в первом backend-task)
- Frontend: `c:\NewProject\taxi-dashboard\frontend\` (React, существующий — НЕ наш target)

## Vehicle model

В existing `CarInspection` авто указывается через `car_number: String(100)`. Возможно есть отдельная модель `Car` в `app/models/car_v2.py` (видел в импортах). Проверим в backend task B2 при создании FK.
