CITYA - Architektura¶

graph TB
    subgraph "Frontend aplikace"
        D[Dispatcher<br/>Vue.js/Quasar]
        PA[Passenger App<br/>Flutter]
        DA[Driver App<br/>Flutter]
    end

    subgraph "Backend"
        API[API Server<br/>.NET 8]
        WS[SignalR Hub<br/>WebSocket]
    end

    subgraph "Databáze"
        PG[(PostgreSQL 13<br/>+ PostGIS)]
        RD[(Redis 7<br/>Cache)]
    end

    subgraph "Externí služby"
        GM[Google Maps API]
        CEDA[CEDA Geocoding]
        GCS[Google Cloud Storage]
        SMS[SMS Gateway<br/>Vonage/GoSMS]
        STRIPE[Stripe<br/>Platby]
    end

    D --> API
    D --> WS
    PA --> API
    PA --> WS
    DA --> API
    DA --> WS

    API --> PG
    API --> RD
    API --> GM
    API --> CEDA
    API --> GCS
    API --> SMS
    API --> STRIPE

    WS --> RD

erDiagram
    User ||--o{ GeoAreaUser : "přiřazen k"
    GeoArea ||--o{ GeoAreaUser : "má uživatele"
    GeoArea ||--o{ Ride : "obsahuje"
    User ||--o{ Ride : "vytváří"
    Driver ||--o{ Ride : "realizuje"
    Vehicle ||--o{ Ride : "použito pro"
    Shift ||--o{ Ride : "obsahuje"
    Driver ||--o{ Shift : "pracuje"

    User {
        uuid Id PK
        string Email
        string PasswordHash
        string FirstName
        string LastName
        string PhoneNumber
        enum Role
        int Status
        datetime CreatedAt
    }

    GeoArea {
        uuid Id PK
        string Name
        string Code
        geometry Boundary
        json Settings
    }

    Ride {
        uuid Id PK
        uuid AreaId FK
        uuid DriverId FK
        uuid VehicleId FK
        point DepartureCoords
        point ArrivalCoords
        enum Status
        datetime RequestedAt
        datetime StartedAt
        datetime FinishedAt
    }

    Driver {
        uuid Id PK
        string FirstName
        string LastName
        string PhoneNumber
        string LicenseNumber
        enum Status
    }

    Vehicle {
        uuid Id PK
        string LicensePlate
        string Model
        string Color
        int Capacity
    }

    Shift {
        uuid Id PK
        uuid DriverId FK
        uuid AreaId FK
        datetime StartTime
        datetime EndTime
        enum Status
    }

/api/v2/
├── auth/
│   ├── login          POST - Přihlášení
│   └── refresh        POST - Obnovení tokenu
├── areas/
│   ├── GET            - Seznam oblastí
│   └── {id}/          - Detail oblasti
├── areas-secrets/
│   └── GET            - API klíče pro oblast
├── rides/
│   ├── GET            - Seznam jízd
│   ├── POST           - Vytvoření jízdy
│   └── {id}/
│       ├── GET        - Detail jízdy
│       ├── PUT        - Aktualizace
│       └── cancel     POST - Zrušení
├── drivers/
│   ├── GET            - Seznam řidičů
│   └── {id}/status    PUT - Změna stavu
├── shifts/
│   ├── GET            - Seznam směn
│   └── POST           - Vytvoření směny
└── reports/
    └── GET            - Reporty a statistiky

sequenceDiagram
    participant C as Client
    participant A as API
    participant DB as Database

    C->>A: POST /auth/login {email, password}
    A->>DB: Najít uživatele
    DB-->>A: User data
    A->>A: Ověřit BCrypt hash
    A->>A: Generovat JWT
    A-->>C: {token, refreshToken, user}

    Note over C,A: Následné requesty

    C->>A: GET /api/rides<br/>Authorization: Bearer {token}
    A->>A: Validovat JWT
    A->>DB: Query data
    DB-->>A: Rides
    A-->>C: {rides: [...]}

graph LR
    subgraph "Klienti"
        D1[Dispatcher 1]
        D2[Dispatcher 2]
        DA[Driver App]
    end

    subgraph "SignalR Hub"
        RH[RidesHub]
        DH[DriversHub]
    end

    subgraph "Redis"
        RB[Redis Backplane]
    end

    D1 <--> RH
    D2 <--> RH
    DA <--> DH
    RH <--> RB
    DH <--> RB

DISPATCHER_GOOGLE_MAPS_API_KEY=AIza...
PAS_GOOGLE_MAPS_API_KEY=AIza...

┌─────────────────────────────────────────────────────┐
│                    Traefik                          │
│              (Reverse Proxy + SSL)                  │
├─────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐                   │
│  │  Dispatcher │  │   Backend   │                   │
│  │   (nginx)   │  │   (.NET)    │                   │
│  │   :80       │  │   :8080     │                   │
│  └─────────────┘  └─────────────┘                   │
├─────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐                   │
│  │  PostgreSQL │  │    Redis    │                   │
│  │   + PostGIS │  │             │                   │
│  │   :5432     │  │   :6379     │                   │
│  └─────────────┘  └─────────────┘                   │
└─────────────────────────────────────────────────────┘