# Projekty

- [Dokumentacja projektów](/projekty): Jedno miejsce na dokumentację każdego projektu, referencję API, llms.txt i MCP.
- Przejazdy: Wspólne przejazdy na festiwale
  - [Przejazdy](/projekty/przejazdy): API wspólnych przejazdów na festiwale w SzukamAndrzeja.pl.
  - [MCP](/projekty/przejazdy/mcp): Jak dać agentowi AI dostęp do API przejazdów.
  - API
    - Cars
      - [Create a car](/projekty/przejazdy/api/cars/carsCreate): Adds a car to the authenticated user garage.
      - [Delete my car](/projekty/przejazdy/api/cars/carsDelete): Soft-deletes an owned car; refuses when the car is attached to active rides.
      - [Get my car](/projekty/przejazdy/api/cars/carsGet): Returns a garaged car by id. Only the owner can read it.
      - [List my cars](/projekty/przejazdy/api/cars/carsList): Returns cars owned by the currently authenticated user (soft-deleted excluded).
      - [Update my car](/projekty/przejazdy/api/cars/carsUpdate): Updates an owned car. Missing fields stay untouched; empty strings clear nullable fields.
    - Chat
      - [Create conversation](/projekty/przejazdy/api/chat/chatCreate): Creates (or reuses) a conversation between the authenticated user and another ride participant.
      - [List user conversations](/projekty/przejazdy/api/chat/chatList): Returns conversations of the authenticated user with unread counts.
      - [Send chat message](/projekty/przejazdy/api/chat/chatMessageCreate): Sends a message to a conversation the user participates in and notifies the recipient.
      - [List conversation messages](/projekty/przejazdy/api/chat/chatMessagesList): Returns messages of a conversation the user participates in; newest page first pagination ascending.
      - [WebSocket konwersacji](/projekty/przejazdy/api/chat/getPrzejazdyChatWs): Przekazuje żądanie upgrade do Durable Object CHAT_DO (userId i conversationId jako parametry). Po sukcesie 101 Switching Protocols z ramkami JSON.
    - Festivals
      - [Get festival details](/projekty/przejazdy/api/festivals/getPrzejazdyFestival): Returns festival details by slug.
      - [List festivals](/projekty/przejazdy/api/festivals/listPrzejazdyFestivals): Retrieves a list of festivals, optionally filtered by active status.
    - Health
      - [Informacje o buildzie (tylko IS_DEV)](/projekty/przejazdy/api/health/getPrzejazdyDebugInfo): Middleware zwraca 403, gdy IS_DEV !== 'true'; poza produkcją oddaje hash commita, gałąź i datę builda.
      - [Health check](/projekty/przejazdy/api/health/getPrzejazdyHealth): Health probe returning operational status of przejazdy server.
    - Notifications
      - [Mark notification as read](/projekty/przejazdy/api/notifications/notificationMarkRead): Marks a single notification of the authenticated user as read.
      - [List notifications](/projekty/przejazdy/api/notifications/notificationsList): Returns the latest 50 notifications of the authenticated user.
      - [Mark all notifications as read](/projekty/przejazdy/api/notifications/notificationsMarkAllRead): Marks every unread notification of the authenticated user as read.
      - [Strumień SSE licznika nieprzeczytanych](/projekty/przejazdy/api/notifications/streamPrzejazdyNotifications): Server-Sent Events: co 10 s zdarzenie `notification` z { unreadCount }.
    - Profile
      - [Get own profile](/projekty/przejazdy/api/profile/profileMeGet): Returns the profile of the authenticated user and their cars.
      - [Update own profile](/projekty/przejazdy/api/profile/profileMeUpdate): Updates bio and phone of the authenticated user profile.
    - Push
      - [Zapisz subskrypcję push](/projekty/przejazdy/api/push/createPrzejazdyPushSubscription): Zapisuje/odświeża subskrypcję Web Push dla endpointu; konflikt, gdy endpoint należy do innego użytkownika.
      - [Usuń subskrypcję push](/projekty/przejazdy/api/push/deletePrzejazdyPushSubscription): Usuwa subskrypcję zalogowanego użytkownika dla podanego endpointu.
      - [Publiczny klucz VAPID](/projekty/przejazdy/api/push/getPrzejazdyVapidPublicKey): Trasa publiczna; zwraca klucz publiczny albo 503, gdy push nie są skonfigurowane.
    - Reports
      - [Create report](/projekty/przejazdy/api/reports/reportCreate): Reports a ride or a user to the moderation queue.
    - Reservations
      - [Create reservation request](/projekty/przejazdy/api/reservations/reservationsCreate): Passenger requests seats on an active ride; reserves seats atomically, opens a conversation and notifies the driver.
      - [List reservations for a ride](/projekty/przejazdy/api/reservations/reservationsForRide): Returns reservations for the given ride. Driver-only; passenger contact (phone) is exposed only for accepted reservations.
      - [List my reservations](/projekty/przejazdy/api/reservations/reservationsMine): Returns reservations of the currently authenticated user with ride details and driver contact only when the reservation is accepted.
      - [Respond to a reservation](/projekty/przejazdy/api/reservations/reservationsUpdateStatus): Driver accepts/rejects a pending reservation; passenger or driver cancels it. Seats are returned on reject/cancel.
    - Reviews
      - [Create a review](/projekty/przejazdy/api/reviews/reviewsCreate): Leaves a review for a counterpart of a completed ride and refreshes their average rating.
      - [List a user's reviews](/projekty/przejazdy/api/reviews/reviewsUser): Returns public reviews received by the given user (no authentication required).
    - Rides
      - [Cancel ride](/projekty/przejazdy/api/rides/cancelPrzejazdyRide): Cancels an active ride and notifies passengers.
      - [Create a new ride](/projekty/przejazdy/api/rides/createPrzejazdyRide): Creates a new ride for a festival. Author must be authenticated.
      - [Get ride details](/projekty/przejazdy/api/rides/getPrzejazdyRide): Returns full ride details including festival, car, author profile, and route stops.
      - [List user rides](/projekty/przejazdy/api/rides/listPrzejazdyMyRides): Returns all rides created by the currently authenticated user.
      - [List available rides](/projekty/przejazdy/api/rides/listPrzejazdyRides): Returns rides filtered by festival, date, route, and sorted as requested.
      - [Update ride](/projekty/przejazdy/api/rides/updatePrzejazdyRide): Updates ride details. Only ride author can update.
    - Search
      - [Search rides, festivals, and users](/projekty/przejazdy/api/search/searchPrzejazdyRides): Global search matching query string against festival names, ride departure cities, and user names.
    - Stats
      - [Platform stats](/projekty/przejazdy/api/stats/getPrzejazdyStats): Returns platform metrics (total rides, active festivals, passenger seats).
    - Users
      - [Get public user profile](/projekty/przejazdy/api/users/getPrzejazdyPublicUser): Returns public user profile, registered cars, and recent reviews.
    - Webhooks
      - [User deleted webhook](/projekty/przejazdy/api/webhooks/webhookUserDeleted): Deletes every local record of a user removed from the auth service (bearer secret protected).