// structura platformei

Cum funcționează
ShopOS

Trei diagrame care acoperă arhitectura generală, fluxul intern de service și experiența șoferului — de la intrarea camionului până la plecare.

Legendă
Operațiuni interne
Portal șofer
Bază de date / sistem
Utilizatori / externi
01 Arhitectura generală

Cine are acces, ce zone există și cum comunică toate componentele prin baza de date centrală.

shopos / arhitectura-generala.svg
Mecanic Manager OPS Șofer OPERAȚIUNI INTERNE Check-in / Check-out Ordine de lucru Safety Lane Inventar / OPS Dashboard Bază de date — PostgreSQL ServiceEvent · type: internal | external PORTAL ȘOFER Urmărire status real-time Istoric și documente Service extern Auth & Roluri Clerk / NextAuth Notificări push SMS / mobile alert hover pe orice nod pentru detalii
Intern

Check-in / Check-out

Flux SOP digital la poartă. Permit Book, Fuel Card, stare inițială la intrare. QA 3 puncte + semnătură la ieșire.

Intern

Ordine de lucru

Creare, asignare și tracking reparații per camion. Fiecare update declanșează notificări instant.

Intern

Safety Lane

Checklist DOT digital cu foto/video. Raport PDF automat la finalizare. Confirmare vocală la închidere.

Intern

Inventar & OPS Dashboard

Stoc piese cu alerte + KPI-uri live: throughput, eficiență, timp mediu reparație. Țintă: 80%+ eficiență.

Șofer

Urmărire status

Status camion în timp real. ETA estimat actualizat la fiecare modificare a mecanicului.

Șofer

Istoric & documente

Rapoarte DOT, facturi, work orders — accesibile de pe mobil oricând, fără apeluri.

Șofer

Service extern

Log vulcanizare, mecanici terți. Locație, cost, foto factură — în același timeline cu reparațiile interne.

Sistem

ServiceEvent unificat

Un singur model cu type: internal | external — timeline complet per camion în toate rapoartele.

02 Flux intern — de la intrare la ieșire

Cei 7 pași din momentul în care un camion ajunge la poartă până când pleacă. Coloana dreaptă arată ce se întâmplă în sistem în paralel.

shopos / flux-intern.svg
MECANIC / DISPECER SISTEM / BAZĂ DE DATE Camion sosește la poartă Permit Book · Fuel Card · stare inițială Check-in înregistrat Timestamp automat · foto stare ServiceEvent creat type: internal · status: open Work Order creat Asignat mecanic · piese · descriere WorkOrder salvat Notificare push → șofer Mecanic lucrează Updates în timp real · piese scăzute Inventar actualizat Șofer vede status live Safety Lane Checklist DOT · foto/video per punct Raport PDF generat Confirmare vocală · arhivat QA + Check-out 3-point sign-off · semnătură digitală ServiceEvent închis status: closed · cost · durata Camion pleacă Notificare push · docs disponibile hover pe orice pas pentru detalii
01
Start

Camion sosește la poartă

Șoferul sau dispecerul înregistrează intrarea cu Permit Book, Fuel Card și starea inițială vizuală.

Sistem

Sesiune nouă inițializată în interfață

02
Check-in

Check-in înregistrat

Timestamp automat, fotografii ale stării camionului, deschidere ServiceEvent cu status: open.

DB

ServiceEvent creat · type: internal · truck_id · created_at

03
Work Order

Work Order creat și asignat

Asignat mecanicului potrivit. Include problema, piesele necesare, prioritatea și durata estimată.

DB + Push

WorkOrder salvat · notificare push → șofer

04
Lucru

Mecanic lucrează

Progresul e logat în timp real. Piesele folosite scad automat din inventar. Șoferul vede statusul live.

DB

Inventar actualizat · updates[] în WorkOrder

05
Safety Lane

Inspecție DOT

Checklist federal digital, upload foto/video per punct. Confirmare vocală automată la finalizare.

PDF

Raport generat automat · arhivat în ServiceEvent

06
QA

QA + Check-out

Verificare finală în 3 puncte. Semnătură digitală a mecanicului. ServiceEvent închis cu cost total.

DB

status: closed · cost · durata efectivă

07
Final

Camion pleacă

Notificare push trimisă șoferului. Documentele disponibile imediat în portalul mobil.

Push

Notificare → șofer · docs accesibile pe mobil

03 Flux șofer — portalul mobil

Ce vede și ce poate face șoferul din aplicația mobilă: status live, documente și logarea serviciilor externe.

shopos / flux-sofer.svg
Șofer deschide app Autentificare cu rol: driver Dashboard șofer Status camion · alerte · acțiuni rapide Status live camion Etapă curentă · ETA Notificare push Gata · întârziere · etapă Istoric & documente Rapoarte DOT · facturi · WO Descărcare PDF Generat din ServiceEvent Log service extern Vulcanizare · mecanic terț Introduce detalii Locație · cost · foto factură ServiceEvent unificat type: internal | external — acelasi timeline Manager vede tot hover pe orice nod pentru detalii
Șofer

Status live

Etapa curentă, ETA estimat, istoricul modificărilor din zi. Actualizat instant la fiecare update al mecanicului.

Șofer

Notificări push

Camion gata, întârziere cu motiv, Safety Lane finalizat. Livrate fără ca șoferul să fie nevoit să sune.

Șofer

Documente & istoric

Rapoarte DOT, facturi, work orders — toate descărcabile ca PDF direct de pe telefon.

Șofer

Service extern

Log vulcanizare, mecanic terț: locație, cost, foto factură. Apare în același timeline ca serviciile interne.

Sistem

Timeline unificat

Intern și extern converg în ServiceEvent. Managerul vede costul total și istoricul complet per camion.