Munkabringa MVP technikai specifikáció

Állapot: 2026. július 7.

Cél: technikai alapleírás egy későbbi éles Munkabringa MVP rendszerhez.

1. MVP célja

Az MVP célja egy végigkövethető kerékpárlízing folyamat digitalizálása: munkáltató csatlakozik, munkavállaló igényt ad le, kereskedő ajánlatot készít, finanszírozó előminősít, biztosítás aktiválható, a kerékpár átadásra kerül, majd a folyamat státuszokkal és dokumentumokkal követhető.

2. Szerepkörök

• Admin: teljes rendszerfelügyelet, partnerek, felhasználók, folyamatok, tartalmak, riportok.
• Munkáltató: cégadatok, jogosultsági keretek, dolgozói igények, jóváhagyások, riportok.
• Munkavállaló: igénylés, kerékpárválasztás, státuszkövetés, átvételi visszajelzés.
• Payroll / HR: levonások, havi riport, módosítások, kilépők/belépők kezelése.
• Kerékpár kereskedő: készlet, ajánlat, átadás, vázszám, tartozékok, szervizcsomag.
• Finanszírozó: előminősítés, szerződés, fedezet, kifizetés.
• Biztosító: biztosítás aktiválása, kárbejelentés, assistance.
• Szervizpartner: karbantartási munkalap, garancia, helyszíni assistance.
• Támogató/szakmai partner: ESG, jogszabályi input, programriport.

3. Fő entitások

• User: id, név, email, szerepkör, partner_id, státusz, utolsó belépés.
• Partner: id, típus, név, adószám, cím, kapcsolattartó, státusz.
• Employer: partner_id, munkavállalói keret, jogosult dolgozói kör, pilot státusz.
• Employee: id, employer_id, munkavállalói azonosító, Munkabringa ID, státusz.
• BikeInventoryItem: dealer_id, sku, márka, modell, évjárat, kategória, méret, szín, ár, elérhetőség, valid_until.
• LeaseRequest: employee_id, employer_id, státusz, keret, kiválasztott kerékpár, futamidő.
• DealerOffer: lease_request_id, inventory_item_id, ár, szállítás, tartozékok, ajánlat státusz.
• FinanceDecision: lease_request_id, döntés, feltételek, havi díj, szerződésszám.
• InsurancePolicy: lease_request_id, vázszám, csomag, kezdőnap, fedezeti státusz.
• HandoverRecord: vázszám, átadás dátuma, tartozékok, átvevő, kereskedő, státusz.
• ServiceTicket: Munkabringa ID, típus, leírás, időpont, státusz.
• Document: ügy_id, típus, verzió, fájl, aláírási státusz.
• AuditLog: user_id, action, entity_type, entity_id, timestamp, metadata.

4. Javasolt státuszmodell

LeaseRequest státuszok

• draft
• employee_submitted
• employer_review
• employer_approved
• dealer_offer_requested
• dealer_offer_submitted
• finance_precheck
• finance_approved
• finance_rejected
• insurance_pending
• insurance_active
• handover_ready
• handed_over
• active
• change_requested
• closed

DealerOffer státuszok

• draft
• submitted
• clarification_needed
• accepted
• expired
• cancelled

Inventory státuszok

• in_stock
• preorder
• reserved
• sold_out
• expired
• blocked

5. API vázlat

• POST /auth/login
• POST /auth/logout
• GET /me
• GET /partners
• POST /partners
• GET /employers/{id}/employees
• POST /lease-requests
• GET /lease-requests/{id}
• PATCH /lease-requests/{id}/status
• GET /inventory
• POST /inventory/import-preview
• POST /inventory/import-approve
• POST /dealer-offers
• POST /finance-decisions
• POST /insurance-policies
• POST /handover-records
• POST /service-tickets
• GET /documents/{case_id}
• POST /documents/generate
• GET /audit-log

6. Dokumentumok

• Munkáltatói csatlakozási adatlap.
• Keretszerződés előkészítő.
• Munkavállalói igénylap.
• Kereskedői árajánlat.
• Finanszírozói előminősítési lap.
• Lízing szerződés előkészítő.
• Biztosítási fedezetigazolás.
• Átadási jegyzőkönyv.
• Szerviz munkalap.
• Havi payroll riport.

7. Nem funkcionális követelmények

• HTTPS minden környezetben.
• Szerepköralapú hozzáférés.
• Auditnapló minden státusz- és dokumentummódosításra.
• Mentés és visszaállítás.
• GDPR kompatibilis adatmegőrzési szabályok.
• Teszt és éles környezet szétválasztása.
• Exportálható riportok.

8. MVP elfogadási kritérium

Az MVP akkor tekinthető késznek, ha egy teszt munkáltató, egy teszt munkavállaló, egy teszt kereskedő, egy finanszírozói döntés és egy biztosítási aktiválás végigvihető, státuszokkal és dokumentumokkal auditálható módon.