Construcții — ghid de configurare pe SGApps ERP

Poziție onestă: SGApps ERP nu este un software de management construcţii dedicat (nu are grafic Gantt cu drum critic, nu se integrează cu programe de deviz oficiale MD tip WinDoc/eDeviz, nu generează situații de lucrări conform format MADR / Inspectoratului de Stat în Construcţii). Ce oferim este un set de primitive extensibile — șantier ca folder-grup, articol deviz ca folder-produs, etapă construcţie ca invoice lifecycle, evidență materiale + ore-om în stock-logger inalterabil — care se pot configura la cerere pentru firme mici / medii de construcţii care vor evidență materiale, ore muncă, subcontractori și cost pe şantier. Rapoartele oficiale către Inspectoratul de Stat în Construcţii sau formatele deviz oficiale MD rămân majoritar manuale sau customizare separată.

1. Modelul recomandat de entități

Concept business	Entitate ERP	Câmpuri folosite
Șantier / obiectiv construcţie	folder-grup sau POS (după complexitate)	Pentru firme mici — folder-grup per şantier în catalog; pentru firme cu mai multe şantiere simultane și necesar stoc/casă distinct — fiecare şantier ca POS propriu
Etaj / secţiune / zonă în cadrul şantierului	folder-grup sub şantier	params.quantity_available — cantitate lucrări încheiate
Articol deviz (m³ beton, kg armătură, m² zidărie, ml cablu)	folder-produs de tip product	name, SKU, MPN, quantity_unit (m3, kg, m2, ml, buc), photo_* (mostre, execuție), params.* (specificaţie tehnică)
Material achiziţionat (ciment, cărămidă, oţel-beton, faianţă)	folder-produs cu SKU propriu	Stocuri, cost achiziţie per POS/şantier
Etapă lucrare (fundaţie → structură → finisaje)	invoice lifecycle (wip → validated → applied → done)	Fiecare etapă = 1 invoice cu stagii; deblocarea etapei următoare = manuală după acceptare
Ore muncă / echipă / subcontractor	folder-produs tip serviciu (ex.: "oră-zidar", "oră-echipă-electricieni") + invoice consum ore	Se poate configura la cerere ca resursă cu cost/oră per POS
Deviz / subcomandă cu cod temporar (înainte de codificare oficială)	folder-produs cu MPN temporar F:<prefix>:<uid> → upgrade la MPN permanent după emiterea devizului oficial	Pattern din applications/storage-groups-folder-invoices/api.js linia 460
Rețetă tehnologică (1 m³ beton = X kg ciment + Y kg agregate + Z l apă + N ore-om)	product:recipe + bomCycleGenerate	Fiecare rulare consumă materialele + orele exact conform reţetei
Cod deviz / cod ofertă / cod contract	references.json — chei libere	references.santier:cod-contract, references.santier:cod-deviz, references.santier:beneficiar-idno
Multi-şantier cu stoc/cost izolat	params_pos[<pos>]	Aceeaşi cărămidă poate avea cost achiziţie şi stoc diferit între şantiere
Documentație foto evoluţie şantier / calitate lucrări	photo_00..photo_N pe folder-şantier + fişiere ataşate pe invoice-ul-etapă	Fiecare etapă poate acumula foto cronologic

Ce nu e un fit natural: grafic Gantt / diagramă drum critic cu dependințe între activități (finisajele nu pot începe înainte de închiderea structurii) — sistemul nu are componentă de planificare temporală cu vizualizare Gantt. Dependinţele pot fi ținute la nivel de flux (etapa X are stagiu wip până când etapa Y ajunge la done), dar UI-ul de planificare temporală = customizare separată sau integrare externă (ex.: MS Project / OpenProject sau export CSV).

2. Ce se acoperă 1:1 cu primitivele existente

• Catalog articole deviz + materiale + servicii — folder-produs pentru fiecare, folder-grup pentru organizare pe categorii (Ct. structuri, Ct. finisaje, Ct. instalaţii electrice, Ct. instalaţii sanitare). Câmpurile references.* pot stoca cod deviz standard (dacă există unul intern) sau cod contract.
• Recepţie materiale pe şantier — invoice de recepție → decrementează stocul depozitului central + incrementează stocul şantierului; stock-logger (vezi applications/erp/stock-logger/) păstrează urma inalterabilă per operator, per timestamp.
• Consum materiale + ore în etapă lucrare — bomCycleGenerate (vezi applications/horeca/api.js linia 319) rulează reţeta "1 m³ beton = 350 kg ciment + 700 kg agregate + 180 l apă + 6 ore-om" → decrementează stocurile exact cât s-a lucrat.
• Tracking pe etape — invoice cu stagii wip (planificat) → validated (în execuție) → applied (materiale şi ore consumate) → done (recepţionat de beneficiar); trecerea între stagii e manuală sau condiţionată de logică custom la onboarding.
• Cod temporar pentru subcomandă / deviz în lucru — pattern F:<prefix>:<uid> permite deschiderea unui folder-lucrare înainte de emiterea codului oficial de deviz, cu adăugare progresivă de intrări; upgrade la MPN permanent la avizare (applications/storage-groups-folder-invoices/api.js linia 507).
• Evidenţă subcontractor — subcontractor = furnizor identificat prin IDNO în references.json pe factură; ore/lucrări subcontractate = invoice de recepţie servicii cu cost negociat; log-ul rămâne inalterabil.
• Casă/încasare pe şantier — POS-Fiscal + casă de marcat certificată SFS (vezi docs-functionality/module-comune/fiscal-printers.md) pentru încasări directe (comandă suplimentară beneficiar, vânzare rest materiale); e-Factura B2B (applications/e-factura/api.js) pentru facturare beneficiar corporate.
• Alertă stoc material sub minim — configurare pe fiecare material cu stock_min per POS/şantier → Notifications Watcher (applications/erp/notifications-watcher.js) livrează alerte pe dashboard + browser push + audio cue. Trimitere automată SMS/email/Telegram nu e feature product implicit (⚙️ integrare custom).
• Cost intern per etapă / per m² / per m³ — sistemul calculează suma inputurilor (materiale × cost curent) + orele (× tarif/oră) via reţetele BOM + sg.helpers.priceCalculate.
• Registru pierderi materiale (spart, furt, depreciere) — invoice de tip pierdere cu motiv obligatoriu din nomenclator (fixat la cerere: spart_transport, depreciere_umezeala, furt, execuţie_greşită), notă liberă + eventual foto (photo_* pe invoice).
• Multi-şantier cu stoc/cost izolat — mecanismul params_pos[<pos>] permite ca aceeaşi cărămidă să aibă cost achiziţie diferit între şantiere; stocuri, alertă minim, prețuri de deviz calculate distinct.
• Configurare tehnologică versionată — SharedRefs (applications/shared-refs/) permite stocarea rețetei tehnologice per articol deviz cu istoric complet audit-log; recalcularea costurilor pe perioade vechi rămâne corectă contabil.
• Audit fiscal-ready — bonuri fiscale prin casă de marcat + e-Factura B2B; jurnal SNC (211 pentru materiale, 611 pentru consum, 711 pentru execuție lucrări, 216 pentru lucrări în curs) — vezi SNC Moldova.
• Multimedia şantier — photo_00..photo_N pe fiecare invoice-etapă permit documentarea vizuală a stagiilor (fundaţie turnat, cofraj demontat, tencuială aplicată, finisaje) cu timestamp automat.

3. Ce necesită dev/proiect (project scope, nu produs)

• Grafic Gantt / drum critic cu vizualizare temporală + dependinţe între activități + alertă drift termen — nu există componentă de planificare temporală built-in. Estimare orientativă: 6-10 săptămâni.
• Situaţie de lucrări conform format C56 / C57 / C58 MADR (dacă e aplicabil clientului) — nu generăm PDF-urile tipizate; datele sunt disponibile, structurarea în format oficial rămâne manuală sau customizare separată. Estimare: 3-5 săptămâni per format oficial.
• Deviz general integrat (comparaţie plan / executat / rest de executat) cu vizualizare tip formular oficial — modelul cu invoice-stagii acoperă evidența, formatarea vizuală standard e customizare. Estimare: 3-4 săptămâni.
• Modul pontaj pe şantier cu tabletă / cititor amprentă la intrare — bridge AndroidBridge (applications/android-bridge/) are USB/BT/HTTP; driver-ele specifice pentru terminale pontaj sunt configurări per hardware. Estimare: 2-3 săptămâni per model.
• Integrare programe de deviz oficiale (WinDoc, eDeviz, alte) — import/export automat între SGApps și programul de deviz al proiectantului rămâne studiu de caz per format. Estimare: 2-4 săptămâni per program.
• Modul contract / anexă contract cu semnare electronică — nu există flux nativ de semnare digitală contract; se pot ataşa PDF-urile ca fişiere pe folder-şantier.
• Managementul echipamentelor cu regim de utilizare (schele, cofraje, macarale — durată închiriere, cost/zi, disponibilitate multi-şantier) — modelul cu invoice-uri de transfer + stock-logger acoperă evidența, dar UI-ul de calendar disponibilitate = customizare. Estimare: 3-5 săptămâni.
• Import date istorice din alt sistem construcţii — nu există import automat. Migrare = serviciu individual după evaluarea fişierelor sursă.

4. Ce e complet neacoperit sau se face manual

• Autorizația de construire / dosarul de execuţie — nu integrăm portalurile de urbanism / autoritate. Datele proiectului se pot stoca ca ataşamente PDF pe folder-şantier.
• Raportări periodice către Inspectoratul de Stat în Construcţii (ISC) — nu generăm formularele tipizate; datele operaţionale sunt exportabile prin API (JSON), dar formatele oficiale se completează manual.
• Cartea tehnică a construcţiei — nu generăm automat; foto + fişe + certificate se pot stoca ca ataşamente pe folder-şantier, dar consolidarea în format oficial e manuală.
• Certificate de calitate materiale (declaraţii de conformitate) — se stochează ca foto/PDF pe folder-material sau invoice-recepţie, dar validare automată cu registrele producătorilor = nu.
• Modele SSM (protecţia muncii) — nu există modul dedicat; evidența instructaje se poate face ca invoice-uri sau ca ataşamente, dar raportarea oficială către ITM = manual.
• Modul urmărire licitații publice / e-tender — nedocumentat; oferte se pot ține ca ataşamente pe folder-lead.
• Calcul devize la nivelul indicilor MADR / normelor de deviz oficiale — rețetele noastre BOM sunt statice, nu conectate la baza indicilor oficiali actualizaţi periodic; verificarea rămâne responsabilitatea proiectantului.
• Grafic financiar plăţi beneficiar / situaţia decontărilor — se pot construi ca invoice-uri de facturare cu stagii, dar dashboard-ul de gestiune plăţi + alerte scadență = customizare.

5. Scenariu real end-to-end

Context: firmă mică de construcţii, 3 şantiere active (o casă rezidenţială, o extindere magazin, un mic depozit), 2 echipe muncitori + 1 subcontractor instalaţii electrice. POS: 1 birou administrativ + 1 tabletă per şef-şantier.
Recepţie materiale — luni dimineaţă:
08:00 — Șeful şantierului "Casa-Str-Alba-12" primeşte o remorcă cu 200 saci ciment + 500 buc. cărămidă. Deschide HoReCa Dashboard (webapp-ul e generic operaţional; contextul construcţii e configurat la onboarding) → tab Orders → invoice de tip "recepţie-material" cu 2 rânduri:

• Ciment: 200 saci × 40 kg → intrare 8000 kg pe POS "Şantier-Casa-Alba-12"
• Cărămidă: 500 buc.

08:15 — Stagiul invoice devine applied → decrementează din depozitul central (unde erau în tranzit) + incrementează pe POS-şantier. stock-logger înregistrează 2 log-uri cu autor "Andrei (şef şantier)", timestamp, sursă = folder-invoice-recepţie.
Consum materiale — miercuri:
09:00 — Echipa toarnă 4 m³ beton. Șeful de şantier rulează bomCycleGenerate cu mpn="BETON-C20", cycles=4 → reţeta "1 m³ beton" decrementează 1400 kg ciment + 2800 kg agregate + 720 l apă + 24 ore-om.
09:30 — Se descoperă că 30 kg ciment s-au întărit în sac (umezeală) → invoice de pierdere cu motiv depreciere_umezeala + foto (photo_00) cu sacul deteriorat.
Emitere factură beneficiar — vinerea:
16:00 — Administratorul deschide un invoice de tip factură B2B către beneficiar (persoană juridică cu IDNO) cu rânduri corespunzătoare stagiului de execuţie săptămânal → emite via e-Factura SFS (applications/e-factura/api.js). Casa de marcat rămâne opţională (doar pentru beneficiar persoană fizică).
Închidere şantier — la final:
Ultimă zi — Închidere şantier: rapoartele Reports din HoReCa Dashboard afişează:

• Cost total materiale consumate (sumă din BOM cycles rulate)
• Cost ore-om + subcontractor (sumă din invoice-uri servicii)
• Pierderi cu motive (agregare pe subtypes)
• Diferenţa venit facturat − cost intern = marjă șantier (calcul manual la nivel de dashboard; UI dedicat "profit/şantier" ar fi customizare)

Toate log-urile rămân inalterabile pentru audit fiscal ulterior.

6. Ce nu promitem

• Nu suntem un software de management construcţii dedicat — nu concurăm cu produse care oferă grafic Gantt, drum critic, situaţii de lucrări MADR format, integrare cu programe de deviz oficiale.
• Nu automatizăm raportările către ISC / ITM / MADR — datele sunt disponibile, formatele oficiale se completează manual sau prin customizare separată.
• Nu integrăm out-of-the-box cu programele de deviz sau cu portalurile de autorizaţii — sunt studii de caz per format.
• Nu oferim planificare temporală cu drum critic — dependinţele între etape se pot ţine la nivel de flux, dar Gantt-ul vizual = nu built-in.
• Nu calculăm devize la indicii oficiali — reţetele BOM rămân statice, actualizare pe indici oficiali = responsabilitatea proiectantului.
• Nu generăm cartea tehnică a construcţiei — foto + certificate se pot stoca, dar consolidarea în format oficial e manuală.

7. Scoring (0-100% per dimensiune)

Dimensiune	Pondere	Scor	Notă onestă
Model de date	25%	65%	Primitivele acoperă şantier, articol deviz, material, etapă lucrare, subcontractor, cost intern. Lipsă model Gantt / drum critic — se poate adăuga la nivel de flux, nu ca UI.
Fluxuri operaționale zilnice	25%	60%	Recepţie materiale, consum via BOM cycle, pierderi cu motiv, transfer inter-şantier, emitere factură beneficiar — toate rulează cu primitivele existente. UI tabletă e generic, nu are gesturi specifice şantier (input rapid consum, scan cod material, foto-pe-etapă tag automat).
Rapoarte management	15%	50%	Storage-groups + shift close + Top losses dau agregări generice. Profit/şantier, comparaţie planificat vs. executat, cash-flow multi-şantier = customizare.
Rapoarte oficiale autoritate	15%	20%	Formulare ISC / MADR / cartea tehnică nu au template. Datele brute sunt exportabile prin API JSON; formatarea oficială e nedocumentată.
Integrări specifice vertical	10%	15%	Bridge Android oferă infra, dar programe deviz oficiale MD / senzori pontaj / e-tender = configurări per proiect.
Documentație existentă	10%	5%	Prima pagină dedicată construcţii; fără capturi/scenarii vizuale încă.

Total ponderat: ~46%
Interpretare: SGApps ERP poate rula operaţional o firmă mică sau medie de construcţii care are nevoie de evidenţă materiale, ore muncă, subcontractori şi cost per şantier cu audit fiscal complet. Zonele de planificare temporală (Gantt), rapoarte oficiale autoritate şi integrare cu programe deviz oficiale rămân majoritar în afara scope-ului out-of-the-box — verificare fit în etapa de descoperire înainte de contractare.

Următorul pas

• Landing verticale
• Programează un apel pentru evaluare fit vertical construcţii