Tutto ciò che serve per installare, configurare e utilizzare OpenConstructionERP per la stima professionale dei costi di costruzione.
Onboarding → Nuovo progetto → BoQ → Collegamento BIM → DWG → Takeoff PDF → Stima completa → Attività → Data Explorer → Stima AI → Portfolio.
Sottotitoli, capitoli e riproduzione a 1,5× sono integrati nel player qui sopra. Preferisci guardare direttamente su YouTube? ▶ Apri su YouTube · iscriviti al canale per le guide pratiche delle nuove versioni.
Ogni blocco qui sotto è una breve GIF estratta dalla guida pratica completa qui sopra, nello stesso ordine del video, così puoi passare direttamente al flusso di lavoro che più ti interessa. Vuoi un flusso continuo? ▶ Guarda la guida pratica di 12 minuti su YouTube.
OpenConstructionERP è una piattaforma completa per la stima dei costi di costruzione e la gestione dei progetti che funziona interamente sul tuo computer. Sostituisce le costose suite commerciali di computo con un'alternativa aperta e self-hosted. La piattaforma copre l'intero ciclo di vita della costruzione, dagli studi di fattibilità iniziali e il computo delle quantità alla preparazione dettagliata del BOQ, alle gare, al confronto delle offerte, all'esecuzione del progetto, alla gestione della qualità e al controllo finanziario. Tutti i tuoi dati restano sul tuo server. Nessuna dipendenza dal cloud, nessun abbonamento, nessun costo per postazione.
Novità della v18.5.0: oltre 190 moduli che coprono l’intero ciclo di vita della costruzione: rubrica contatti, attività con Kanban, tracciamento RFI, finanza (fatture, budget, EVM), acquisti, sicurezza, riunioni, controlli qualità, NCR, submittal, corrispondenza, CDE (ISO 19650), transmittal, BIM Hub, registro cespiti con export COBie, reporting & dashboard KPI, markup (PDF↔DWG↔hub), visualizzazioni pivot & selettore colonne per grafici, servizio e-mail modulare, contatti multi-tenant, report pianificati, Regional Pack e import/export completo.


Computi metrici gerarchici con sezioni, posizioni, risorse, assemblaggi e ricarichi automatici.
Basi di costo da 9 fonti nazionali, pubblicate in 48 edizioni di mercato con valuta e lingua locali, con 36 database regionali pronti da importare.
Genera il BOQ da testo, foto, PDF, Excel o modelli CAD/BIM usando qualsiasi provider LLM.
Estrai le quantità da RVT, IFC, DWG, DGN tramite i convertitori DDC.
Programmazione Gantt con CPM, Earned Value Management, curva a S, simulazione Monte Carlo.
Finanza, Sicurezza, Qualità, CDE, BIM Hub, Approvvigionamento, RFI, Attività, Riunioni e altro ancora. Attiva solo ciò che ti serve.
Dopo aver installato OpenConstructionERP, segui questi passaggi per configurare il tuo primo progetto e creare la tua prima stima dei costi. L'intero processo richiede circa 10 minuti.
Apri il browser e vai a http://localhost:5173 (sviluppo locale) oppure http://localhost:8080 (Docker). Vedrai la pagina di login con un pannello "Accesso demo". Fai clic su Admin per accedere istantaneamente con l'account demo, oppure inserisci le tue credenziali se hai registrato un nuovo account.
Al primo accesso, la procedura guidata di onboarding ti accompagna nella configurazione iniziale:
Fai clic su Nuovo progetto nella Dashboard o vai a Progetti. Compila:
Dopo aver creato il progetto, vieni reindirizzato alla pagina di dettaglio del progetto, dove puoi iniziare ad aggiungere BOQ.
Dalla pagina del progetto, fai clic su Nuova stima. Assegnale un nome (ad esempio "Stima dei costi v1") e, facoltativamente, scegli un modello. L'editor BOQ si apre con una griglia vuota pronta per la tua prima posizione.
Nell'editor BOQ, fai clic su Aggiungi posizione o premi Invio su una riga vuota. Compila:
La colonna Totale viene calcolata automaticamente (Quantità x Prezzo unitario). Puoi anche cercare nel database dei costi facendo clic sull'icona del database accanto a una qualsiasi posizione per trovare e applicare un prezzo dalle oltre 120.000 voci CWICR.
OpenConstructionERP è progettato per essere facile da installare indipendentemente dalle tue competenze tecniche. Scegli il metodo più adatto alla tua configurazione, tutte le opzioni richiedono meno di 5 minuti. L'applicazione utilizza per impostazione predefinita un PostgreSQL incorporato (senza Docker, senza un server di database separato, senza configurazione), quindi tutto funziona immediatamente. Richiede Python 3.12+ per i percorsi pip e a riga singola.
pip install --upgrade openconstructionerp
openconstructionerpInstalla il backend + il frontend React precompilato in un unico wheel. Si apre su http://localhost:8080 con l'interfaccia completa. PostgreSQL integrato, zero configurazione. Se qualcosa non funziona, esegui openconstructionerp doctor.
Su Ubuntu 23.04+ (incluso Ubuntu 26) e Debian 12+, pip install direttamente nel Python di sistema fallisce con error: externally-managed-environment (PEP 668). Usa invece un ambiente virtuale:
# Ubuntu 26 - install Python 3.12 explicitly if needed
sudo apt install -y python3.12 python3.12-venv
# Create and activate a venv, then install
python3.12 -m venv ~/ocerp-venv
source ~/ocerp-venv/bin/activate
pip install --upgrade openconstructionerp
openconstructionerpSe pip ricorre a una compilazione dai sorgenti, installa gli header: sudo apt install -y build-essential libpq-dev libjpeg-dev zlib1g-dev libgeos-dev. Guida completa per Linux con risoluzione dei problemi: docs/INSTALL_LINUX.md.
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.ps1 | iexSceglie Docker se installato, altrimenti uv, altrimenti pip. Funziona su http://localhost:8080.
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
make quickstartSi apre su http://localhost:8080 (~2 min per la prima compilazione).
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
# Backend (embedded PostgreSQL, zero config)
cd backend && pip install -r requirements.txt
uvicorn app.main:create_app --factory --reload --port 8000
# Frontend (new terminal)
cd frontend && npm install && npm run devBackend: http://localhost:8000 / Frontend: http://localhost:5173
| Account | Password | Ruolo | |
|---|---|---|---|
| Admin | demo@openconstructionerp.com | DemoPass1234! | Accesso completo |
| Estimator | estimator@openconstructionerp.com | DemoPass1234! | Computista |
| Manager | manager@openconstructionerp.com | DemoPass1234! | Manager |
5 progetti demo (Berlino, Londra, New York, Parigi, Dubai) con BOQ, programmi e modelli di costo completi.
L'editor del computo metrico è dove passerai la maggior parte del tuo tempo. Offre un'interfaccia professionale simile a un foglio di calcolo, basata su AG Grid, con funzionalità specifiche per le costruzioni integrate: sezioni gerarchiche, collegamento delle risorse, ricette di assemblaggio e calcolo automatico dei ricarichi. Ogni modifica è tracciata con pieno supporto annulla/ripeti. 42 regole di validazione vengono eseguite automaticamente in background, individuando errori come quantità mancanti, prezzi a zero, posizioni duplicate e problemi di conformità alla classificazione prima che diventino problemi.
🎬 Guarda l'editor BOQ in azione su YouTube - editing da tastiera, oltre 120.000 voci con prezzo, punteggio di qualità in tempo reale.



Le sezioni organizzano il tuo BOQ in gruppi logici (ad esempio, "300 Struttura", "400 HVAC"). Per creare una sezione:
Puoi comprimere/espandere le sezioni per concentrarti su lavorazioni specifiche. Trascina le sezioni per riordinare l'intera struttura del BOQ.
Ogni posizione BOQ può avere risorse collegate che scompongono il prezzo unitario nei suoi componenti:
Per aggiungere risorse: espandi la riga di una posizione, fai clic su "Aggiungi risorsa", cerca nel catalogo, imposta il fattore di quantità (ad esempio, 120 kg di armatura per m3 di calcestruzzo). Il prezzo unitario della posizione si aggiorna automaticamente dalla somma delle sue risorse.
I ricarichi vengono applicati dopo il totale netto (somma di tutte le posizioni). I ricarichi comuni includono:
Fai clic su Aggiungi markup nella barra degli strumenti. Puoi impostare valori regionali predefiniti o personalizzarli per progetto. I markup possono essere percentuali o importi fissi e si compongono in ordine (prima le spese generali, poi l'utile sull'importo comprensivo delle spese generali, infine l'IVA sul totale).
Premi Ctrl+Maiusc+V o fai clic sull'icona dello scudo nella barra degli strumenti per eseguire la validazione. Il sistema verifica il tuo BOQ rispetto ai set di regole selezionati e mostra i risultati inline:
L'editor BOQ supporta l'importazione da più fonti:
| Scorciatoia | Azione |
|---|---|
Ctrl+K | Palette dei comandi |
Ctrl+N | Nuovo progetto |
Ctrl+Shift+V | Esegui validazione |
Ctrl+Z / Y | Annulla / Ripeti |
Accedi al più grande database di costi di costruzione open source al mondo: oltre 120.000 voci di costo in oltre 40 regioni. Il database globale CWICR contribuisce con oltre 55.000 voci con descrizioni in un massimo di 9 lingue, organizzate per lavorazione (movimento terra, calcestruzzo, muratura, acciaio, coperture, facciate, HVAC, impianti elettrici, idraulica, finiture, sistemazioni esterne). Ogni voce comprende un’unità di misura, la tariffa base per la regione indicata, codici di classificazione (DIN 276, NRM, MasterFormat) e, quando disponibile, la scomposizione in materiali, manodopera e attrezzature.


| Regione | Valuta | Standard | Voci |
|---|---|---|---|
| Germania (DACH) | EUR | DIN 276 | 55,719 |
| Regno Unito | GBP | NRM 1/2 | 55,719 |
| Stati Uniti | USD | MasterFormat | 55,719 |
| Francia | EUR | DPGF | 55,719 |
| Russia | RUB | GESN | 55,719 |
| Emirati Arabi Uniti | AED | Locale | 55,719 |
| Cina | CNY | GB/T | 55,719 |
| India | INR | CPWD | 55,719 |
Il database dei costi è progettato per due flussi di lavoro principali:
Ogni voce di costo contiene:
Attiva la ricerca semantica per trovare le voci di costo per significato, non solo per corrispondenza esatta di parole chiave. Quando cerchi "muro in calcestruzzo", il sistema trova anche voci come "parete armata C30/37, 24cm con casseratura", anche se le parole esatte non compaiono. Tutto questo è reso possibile dagli embedding sentence-transformer, che convertono le descrizioni in vettori numerici e trovano le corrispondenze più vicine in uno spazio multidimensionale. Sono supportati due backend di database vettoriali: LanceDB (integrato, funziona in-process come SQLite, embedding a 384 dimensioni) e Qdrant (server di produzione con snapshot precompilati a 3072 dimensioni scaricabili da GitHub).
Estrai le quantità direttamente dai disegni e dai modelli del tuo progetto, senza alcun conteggio manuale. Carica file RVT, IFC, DWG o DGN e il sistema estrae ogni elemento dell'edificio con volumi, aree e lunghezze. Per i disegni PDF, aprili direttamente nel browser e usa strumenti di misurazione calibrati per rilevare distanze, aree e conteggi degli elementi. Tutte le quantità estratte possono essere trasferite a un BOQ per l'assegnazione dei prezzi.





| Formato | Software | Convertitore |
|---|---|---|
| .rvt / .rfa | BIM | DDC RvtExporter |
| .ifc | IFC (qualsiasi BIM) | DDC IfcExporter |
| .dwg / .dxf | CAD | DDC DwgExporter |
| .dgn | CAD | DDC DgnExporter |
Collega qualsiasi provider LLM per generare stime dei costi di costruzione a partire da semplici descrizioni testuali, foto di edifici, PDF scansionati, fogli di calcolo Excel o modelli CAD/BIM. Il sistema AI crea posizioni BOQ complete con quantità e prezzi a valori di mercato. Dopo la generazione, puoi abbinare ogni voce al database dei costi CWICR per sostituire i prezzi stimati dall'AI con prezzi di mercato regionali verificati. Le funzionalità AI sono interamente opzionali: la piattaforma funziona pienamente anche senza di esse.
🎬 Guarda "Stima AI da una foto" su YouTube - carica una foto di cantiere e ottieni un BOQ definito in pochi secondi.


| Provider | Modelli | Funzionalità |
|---|---|---|
| Anthropic | Claude Sonnet / Opus | Testo, visione, documenti |
| OpenAI | GPT-4o | Testo, visione, documenti |
| Gemini Pro | Testo, visione | |
| Mistral / Groq / DeepSeek | Vari | Testo |
Descrivi il tuo progetto in testo semplice e l'AI genera 15-30 voci BOQ con quantità e prezzi di mercato.
Abbina le stime AI al database CWICR per sostituire i prezzi ipotizzati con prezzi di mercato reali.
Chatta con l'AI su costi, materiali e prezzi usando il tuo database dei costi come contesto.

Pianifica la tempistica del tuo progetto di costruzione e monitora i costi nel tempo con strumenti integrati di programmazione e modellazione finanziaria.
Il modulo di programmazione offre un diagramma di Gantt professionale per gestire la tempistica della tua costruzione. Crea attività, imposta durate, definisci dipendenze e il sistema calcola automaticamente il percorso critico, mostrando quali attività non devono subire ritardi.
Il modello di costo collega i dati del tuo BOQ alla tempistica del progetto, offrendoti una visione dei costi di costruzione distribuiti nel tempo con le metriche dell'Earned Value Management.
Gestisci l'intero flusso di lavoro di approvvigionamento, dalla creazione dei pacchetti di gara al confronto delle proposte e all'aggiudicazione dei contratti ai subappaltatori.
Vai su Approvvigionamento, seleziona un progetto e fai clic su "Crea pacchetto". Specifica il nome del pacchetto, la descrizione dell'ambito, il termine di presentazione e seleziona quali posizioni BOQ includere. Puoi creare più pacchetti per progetto (ad esempio, opere strutturali, MEP, finiture).
Aggiungi le offerte dei subappaltatori con il nome dell'azienda, i dati di contatto e i prezzi quotati per ogni posizione BOQ. Il sistema supporta più offerte per pacchetto per un confronto fianco a fianco.
Il quadro comparativo dei prezzi mostra tutte le offerte in una tabella di confronto con i prezzi unitari e i totali per posizione. Indicatori visivi evidenziano l'offerta più bassa e quella più alta. Esporta il confronto in CSV per la revisione degli stakeholder.
Contrassegna l'offerta vincente con il pulsante Aggiudica e aggiungi note di motivazione. Lo stato del pacchetto avanza attraverso: Bozza, Emesso, In raccolta, In valutazione, Aggiudicato, Chiuso.
Identifica, valuta e gestisci i rischi di progetto usando una matrice probabilità-impatto. Quantifica l'esposizione al rischio e pianifica le strategie di mitigazione per ogni rischio identificato.
La matrice visualizza tutti i rischi su una griglia probabilità (0,1-0,9) vs impatto (basso/medio/alto/critico) con codifica a colori. Ogni rischio mostra il punteggio di esposizione calcolato (probabilità moltiplicata per il costo dell'impatto).
Per ogni rischio, documenta: codice univoco (R-001), titolo, categoria (tecnico, finanziario, programmazione, normativo, ambientale, sicurezza), strategia di mitigazione, piano di emergenza, responsabile del rischio, impatto sui costi e impatto sul programma in giorni. Monitora lo stato attraverso: Identificato, Valutato, In mitigazione, Chiuso o Verificatosi.
Monitora le variazioni di ambito e il loro impatto su costi e tempi del progetto. Gli ordini di variazione forniscono una pista di controllo di tutte le modifiche apportate dopo la stima iniziale.
Crea un ordine di variazione con codice (CO-001), titolo e categoria di motivazione (richiesta del cliente, modifica progettuale, condizione imprevista, normativa). Aggiungi voci specificando le posizioni BOQ interessate con quantità/prezzi originali e nuovi. Il sistema calcola automaticamente le differenze di costo. Lo stato avanza attraverso: Bozza, Presentato, In revisione, Approvato/Respinto.

Esegui controlli di qualità automatizzati sui tuoi BOQ per individuare gli errori prima che diventino problemi. Il motore di validazione applica 42 regole configurabili ai dati della tua stima.
Ogni validazione produce un punteggio di qualità (0-100%) con risultati codificati a colori: Errori (rosso, da correggere), Avvisi (giallo, da verificare), Info (blu, suggerimenti). Fai clic su un risultato qualsiasi per navigare direttamente alla posizione BOQ interessata.



Genera documenti professionali dai dati del tuo progetto per stakeholder, clienti e conformità normativa.

Centralizza tutti i documenti di progetto. Carica disegni, contratti, specifiche e foto con categorizzazione e ricerca automatiche.


Visualizza le prestazioni di budget tra i progetti. La dashboard aggrega i dati finanziari di tutti i progetti per individuare tendenze, scostamenti e budget a rischio.
Gestisci tutti gli stakeholder del progetto in una rubrica centralizzata. Tieni traccia di clienti, subappaltatori, fornitori, architetti e consulenti con dati di contatto completi, associazioni aziendali e categorizzazione per ruolo. Collega i contatti a progetti, gare, ordini di acquisto e corrispondenza per una tracciabilità completa.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/contacts/ | Elenca tutti i contatti |
| POST | /api/v1/contacts/ | Crea contatto |
| GET | /api/v1/contacts/{id} | Ottieni i dettagli del contatto |
| PUT | /api/v1/contacts/{id} | Aggiorna contatto |
| POST | /api/v1/contacts/import | Importa contatti in blocco |
Organizza il lavoro di progetto con una tassonomia di 5 tipi di attività e una bacheca Kanban visiva. Le attività possono essere assegnate ai membri del team, collegate a posizioni BOQ specifiche, documenti o RFI, e monitorate attraverso fasi di flusso di lavoro personalizzabili. Ogni tipo di attività ha una propria codifica a colori e campi predefiniti.

| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/tasks/ | Elenca le attività (filtrabili per progetto, assegnatario, stato) |
| POST | /api/v1/tasks/ | Crea attività |
| PATCH | /api/v1/tasks/{id} | Aggiorna attività (stato, assegnatario, priorità) |
| GET | /api/v1/tasks/board/{project_id} | Ottieni i dati della bacheca Kanban |
Tieni traccia delle richieste formali di informazioni tra le parti del progetto con assegnazione ball-in-court. Le RFI seguono un ciclo di vita strutturato dalla bozza alla chiusura, garantendo che ogni domanda riceva una risposta documentata. Il monitoraggio ball-in-court mostra in ogni momento chi detiene attualmente la responsabilità dell'azione.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/rfis/ | Elenca le RFI |
| POST | /api/v1/rfis/ | Crea RFI |
| POST | /api/v1/rfis/{id}/respond | Invia risposta |
| PATCH | /api/v1/rfis/{id}/status | Aggiorna stato / ball-in-court |
Gestione finanziaria completa del progetto che copre fatture, budget, pagamenti ed Earned Value Management (EVM). Tieni traccia dei costi previsti rispetto a quelli effettivi, genera richieste di pagamento e monitora lo stato di salute del budget con analisi degli scostamenti in tempo reale. Si integra con i dati BOQ per la generazione automatica della baseline dei costi.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/finance/invoices/ | Elenca le fatture |
| POST | /api/v1/finance/invoices/ | Crea fattura |
| GET | /api/v1/finance/budgets/ | Elenca i budget |
| POST | /api/v1/finance/budgets/import | Importa budget da Excel |
| GET | /api/v1/finance/evm/{project_id} | Ottieni le metriche EVM |
| GET | /api/v1/finance/payments/ | Elenca i pagamenti |
Gestisci gli ordini di acquisto e le ricevute merci per materiali e servizi di costruzione. Crea ordini di acquisto collegati alle posizioni BOQ, tieni traccia dello stato delle consegne e registra le ricevute merci con verifica delle quantità. Si integra con il modulo Contatti per la gestione dei fornitori.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/procurement/orders/ | Elenca gli ordini di acquisto |
| POST | /api/v1/procurement/orders/ | Crea ordine di acquisto |
| POST | /api/v1/procurement/orders/{id}/receive | Registra ricevuta merci |
| GET | /api/v1/procurement/receipts/ | Elenca le ricevute merci |
Registra incidenti di sicurezza, mancati incidenti e osservazioni comportamentali con un sistema di punteggio del rischio. Tieni traccia delle metriche di performance della sicurezza tra i progetti, individua le tendenze e garantisci la conformità alle normative in materia di salute e sicurezza sul lavoro.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/safety/incidents/ | Elenca gli incidenti |
| POST | /api/v1/safety/incidents/ | Segnala incidente |
| GET | /api/v1/safety/observations/ | Elenca le osservazioni |
| POST | /api/v1/safety/observations/ | Registra osservazione |
| GET | /api/v1/safety/dashboard/{project_id} | Ottieni i KPI di sicurezza |
Gestisci i verbali delle riunioni con ordini del giorno strutturati e azioni monitorate. Crea serie di riunioni ricorrenti (ad esempio riunioni di cantiere settimanali), registra i partecipanti, annota i punti di discussione e genera automaticamente azioni che si integrano con il modulo Attività.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/meetings/ | Elenca le riunioni |
| POST | /api/v1/meetings/ | Crea riunione |
| GET | /api/v1/meetings/{id}/minutes | Ottieni il verbale della riunione |
| POST | /api/v1/meetings/{id}/actions | Aggiungi azione |
Esegui ispezioni di qualità utilizzando checklist configurabili. Definisci modelli di ispezione per ogni mestiere o tipo di attività, compilali in cantiere, allega foto e tieni traccia della risoluzione delle non conformità. I risultati delle ispezioni alimentano il punteggio di qualità del progetto e il flusso di lavoro NCR.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/inspections/ | Elenca le ispezioni |
| POST | /api/v1/inspections/ | Crea ispezione da modello |
| GET | /api/v1/inspections/templates/ | Elenca i modelli di checklist |
| PATCH | /api/v1/inspections/{id}/items | Aggiorna i risultati delle voci della checklist |
Documenta e tieni traccia delle non conformità di qualità quando il lavoro non soddisfa le specifiche. Le NCR seguono un ciclo di vita formale dall'identificazione all'analisi delle cause profonde fino alla verifica delle azioni correttive, garantendo che tutte le deviazioni di qualità siano correttamente risolte e documentate.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/ncr/ | Elenca le NCR |
| POST | /api/v1/ncr/ | Crea NCR |
| PATCH | /api/v1/ncr/{id}/status | Aggiorna lo stato della NCR |
| POST | /api/v1/ncr/{id}/actions | Aggiungi azione correttiva |
Gestisci il processo di revisione dei submittal per materiali da costruzione, disegni costruttivi e dati di prodotto. Tieni traccia dei flussi di lavoro di revisione multilivello in cui i submittal passano attraverso più revisori prima dell'approvazione finale. Mantieni una traccia di audit completa di tutti i cicli di revisione e della cronologia delle revisioni.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/submittals/ | Elenca i submittal |
| POST | /api/v1/submittals/ | Crea submittal |
| POST | /api/v1/submittals/{id}/review | Invia decisione di revisione |
| POST | /api/v1/submittals/{id}/revise | Carica nuova revisione |
Mantieni un registro formale delle comunicazioni per tutta la corrispondenza del progetto. Tieni traccia di lettere, email, avvisi e istruzioni tra le parti del progetto con numeri di riferimento univoci, monitoraggio delle risposte e ricerca full-text. Garantisce che le comunicazioni contrattuali siano correttamente documentate e tracciabili.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/correspondence/ | Elenca la corrispondenza |
| POST | /api/v1/correspondence/ | Crea voce di corrispondenza |
| GET | /api/v1/correspondence/{id} | Ottieni i dettagli con gli allegati |
| GET | /api/v1/correspondence/{id}/thread | Ottieni la catena di corrispondenza collegata |
Ambiente di dati condivisi conforme alla ISO 19650 per la gestione delle informazioni di progetto con transizioni di stato controllate. I documenti passano attraverso gli stati Work in Progress (WIP), Condiviso, Pubblicato e Archiviato con gate di approvazione. Garantisce che la gestione delle informazioni segua gli standard BIM per la consegna collaborativa.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/cde/documents/ | Elenca i documenti CDE (filtrabili per stato, idoneità) |
| POST | /api/v1/cde/documents/ | Carica documento nel CDE |
| PATCH | /api/v1/cde/documents/{id}/status | Cambia lo stato del documento |
| GET | /api/v1/cde/documents/{id}/history | Ottieni la cronologia delle revisioni |
Distribuisci formalmente i documenti a parti esterne con consegna e conferma di ricezione monitorate. Crea pacchetti di trasmittali contenenti più documenti, specifica i destinatari e tieni traccia se ciascun destinatario ha ricevuto e confermato i documenti. Fornisce un registro contrattuale dello scambio di informazioni.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/transmittals/ | Elenca i trasmittali |
| POST | /api/v1/transmittals/ | Crea trasmittale |
| POST | /api/v1/transmittals/{id}/send | Invia trasmittale ai destinatari |
| PATCH | /api/v1/transmittals/{id}/acknowledge | Registra la conferma di ricezione del destinatario |
Hub centrale per la gestione dei modelli BIM con accesso ai dati a livello di elemento e collegamento diretto al BOQ. Carica modelli IFC/RVT, esplora gli elementi edilizi con le loro proprietà e quantità e collega gli elementi alle posizioni BOQ per l'integrazione dei costi 5D. Fornisce un ponte tra i dati di progettazione e la stima dei costi.
🎬 Demo del collegamento massivo BIM su YouTube - 100 muri BIM → una riga BOQ con area, volume e lunghezza aggregati.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/bim/models/ | Elenca i modelli BIM |
| POST | /api/v1/bim/models/ | Carica modello BIM |
| GET | /api/v1/bim/models/{id}/elements | Elenca gli elementi del modello |
| POST | /api/v1/bim/elements/{id}/link-boq | Collega elemento a posizione BOQ |
Motore di reportistica completo con dashboard KPI, modelli di report personalizzabili e generazione programmata di report. Aggrega i dati tra i progetti per ottenere informazioni a livello di portfolio. Crea modelli di report personalizzati combinando i dati di qualsiasi modulo (BOQ, Finanza, Pianificazione, Sicurezza, Qualità).
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/reporting/kpi/{project_id} | Ottieni i KPI del progetto |
| GET | /api/v1/reporting/templates/ | Elenca i modelli di report |
| POST | /api/v1/reporting/generate | Genera report da modello |
| GET | /api/v1/reporting/portfolio/ | Ottieni i dati della dashboard del portfolio |
Sistema di notifiche in-app che tiene gli utenti informati sugli eventi a loro rilevanti. Le notifiche sono attivate da azioni in tutti i moduli - assegnazioni di attività, risposte a RFI, revisioni di submittal, richieste di approvazione, elementi scaduti e altro ancora. Gli utenti controllano le proprie preferenze di notifica per categoria.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/notifications/ | Elenca le notifiche (prima le non lette) |
| PATCH | /api/v1/notifications/{id}/read | Segna notifica come letta |
| POST | /api/v1/notifications/read-all | Segna tutte come lette |
| GET | /api/v1/notifications/preferences | Ottieni le preferenze di notifica |
Diagramma di Gantt basato puramente su SVG per la visualizzazione della pianificazione dei lavori. Renderizza cronologie, dipendenze, milestone e percorso critico direttamente nel browser senza librerie esterne. Supporta lo zoom da viste a livello di giorno a viste a livello di anno ed esporta in PDF/PNG per la reportistica.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/schedule/gantt/{project_id} | Ottieni i dati del diagramma di Gantt (attività, dipendenze) |
| PATCH | /api/v1/schedule/activities/{id} | Aggiorna date/avanzamento dell'attività |
| POST | /api/v1/schedule/dependencies/ | Crea dipendenza |
Configura le preferenze di fuso orario, valuta, formato dei numeri e formato delle date per ogni utente e per ogni progetto. Le impostazioni regionali si propagano a cascata dai valori predefiniti di sistema agli override a livello di progetto fino alle preferenze a livello di utente, garantendo che ogni membro del team veda i dati formattati in base alle proprie impostazioni locali.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/settings/regional/ | Ottieni le impostazioni regionali correnti |
| PUT | /api/v1/settings/regional/ | Aggiorna le impostazioni regionali |
| GET | /api/v1/settings/regional/timezones | Elenca i fusi orari disponibili |
| GET | /api/v1/settings/regional/currencies | Elenca le valute supportate |
Abilita o disabilita i moduli della piattaforma per personalizzare OpenConstructionERP in base al tuo flusso di lavoro. Ogni modulo può essere attivato in modo indipendente senza influire sugli altri moduli. I moduli disabilitati vengono nascosti dall'interfaccia, i loro endpoint API restituiscono 404 e le loro tabelle del database rimangono intatte per la riattivazione.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/modules/ | Elenca tutti i moduli con stato |
| PATCH | /api/v1/modules/{name}/toggle | Abilita o disabilita un modulo |
| GET | /api/v1/modules/{name}/dependencies | Controlla le dipendenze del modulo |
Pacchetti regionali preconfigurati che impostano standard di classificazione, regole fiscali, valori predefiniti del database dei costi, modelli di report e regole di conformità normativa per mercati specifici. Installa un pacchetto regionale per configurare immediatamente la piattaforma per il tuo paese o la tua regione.
| Pacchetto | Regione | Standard | Valuta |
|---|---|---|---|
| US | Stati Uniti | MasterFormat, UniFormat, CSI | USD |
| DACH | Germania, Austria, Svizzera | DIN 276, GAEB, VOB, HOAI | EUR/CHF |
| UK | Regno Unito | NRM 1/2, RICS, JCT | GBP |
| Russia | Russia, CSI | GESN, FER, TER, SNIP | RUB |
| Medio Oriente | Emirati Arabi Uniti, Arabia Saudita, Qatar | RICS, CESMM, FIDIC | AED/SAR/QAR |
| Asia-Pacific | Cina, Giappone, Australia | GB/T, AS 4000, JASS | CNY/AUD/JPY |
| India | India | CPWD, IS standards, DSR | INR |
| LatAm | Brasile, Messico, Colombia | SINAPI, CMIC, local norms | BRL/MXN/COP |
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/regional-packs/ | Elenca i pacchetti regionali disponibili |
| POST | /api/v1/regional-packs/{name}/install | Installa pacchetto regionale |
| GET | /api/v1/regional-packs/{name}/details | Ottieni contenuti e configurazione del pacchetto |
Funzionalità complete di importazione ed esportazione dei dati in tutti i moduli. Importa contatti, budget, BOQ e database dei costi da file Excel e CSV con mappatura intelligente delle colonne. Esporta i dati di progetto in Excel, PDF e CSV con modelli personalizzabili. Tutte le esportazioni preservano la formattazione e includono intestazioni di metadati.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| POST | /api/v1/import/contacts | Importa contatti da file |
| POST | /api/v1/import/budget | Importa budget da Excel |
| POST | /api/v1/export/boq/{id} | Esporta BOQ (formato: excel, pdf, gaeb, csv) |
| POST | /api/v1/export/report | Genera ed esporta report |



| Variabile | Predefinito | Descrizione |
|---|---|---|
DATABASE_URL | (non impostato = PostgreSQL incorporato) | Database (PostgreSQL incorporato per impostazione predefinita; da impostare per un PostgreSQL esterno). Lascia vuoto per usare il PostgreSQL incorporato, oppure indica un database esterno, ad esempio postgresql+asyncpg://oe:oe@localhost:5432/openestimate. |
JWT_SECRET | dev-key | JWT secret (cambiare in produzione!) |
SEED_DEMO | true | Crea account demo |
VECTOR_BACKEND | lancedb | Backend di ricerca vettoriale |
OpenConstructionERP espone una completa API REST che alimenta il frontend e può essere utilizzata per integrazioni, automazione e workflow personalizzati. Ogni azione disponibile nell'interfaccia, come creare progetti, modificare BOQ, eseguire stime AI, cercare costi, è disponibile come endpoint API. La documentazione Swagger interattiva con pulsanti try-it-out è disponibile su /api/docs quando il backend è in esecuzione.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| POST | /api/v1/users/auth/login | Login |
| GET | /api/v1/projects/ | Elenca i progetti |
| GET | /api/v1/boq/boqs/?project_id=... | Elenca i BOQ |
| GET | /api/v1/costs/?q=concrete | Cerca costi |
| POST | /api/v1/ai/quick-estimate | Stima con AI |
| POST | /api/v1/takeoff/cad-extract | Estrazione CAD |
| GET | /api/health | Controllo dello stato |
| Modulo | Prefisso | Descrizione |
|---|---|---|
| Contacts | /api/v1/contacts/ | CRUD rubrica contatti, importazione |
| Tasks | /api/v1/tasks/ | Gestione attività, bacheca Kanban |
| RFI | /api/v1/rfis/ | Richieste di informazioni |
| Finance | /api/v1/finance/ | Fatture, budget, pagamenti, EVM |
| Procurement | /api/v1/procurement/ | Ordini di acquisto, ricevute merci |
| Safety | /api/v1/safety/ | Incidenti, osservazioni, punteggio del rischio |
| Meetings | /api/v1/meetings/ | Verbali, ordine del giorno, azioni |
| Inspections | /api/v1/inspections/ | Ispezioni di qualità, checklist |
| NCR | /api/v1/ncr/ | Rapporti di non conformità |
| Submittals | /api/v1/submittals/ | Revisione submittal multilivello |
| Correspondence | /api/v1/correspondence/ | Registro delle comunicazioni |
| CDE | /api/v1/cde/ | Ambiente documentale ISO 19650 |
| Transmittals | /api/v1/transmittals/ | Distribuzione dei documenti |
| BIM Hub | /api/v1/bim/ | Modelli BIM, elementi, collegamento BOQ |
| Reporting | /api/v1/reporting/ | Dashboard KPI, modelli di report |
| Notifications | /api/v1/notifications/ | Sistema di notifiche in-app |
| Comments | /api/v1/comments/ | Commenti a thread su qualsiasi entità |
| Gantt | /api/v1/schedule/gantt/ | Visualizzazione pianificazione SVG |
| Regional | /api/v1/settings/regional/ | Fuso orario, valuta, preferenze di formato |
| Modules | /api/v1/modules/ | Abilita/disabilita moduli |
| Regional Packs | /api/v1/regional-packs/ | Installa configurazioni regionali |
| Import/Export | /api/v1/import/ / /api/v1/export/ | Importazione ed esportazione massiva dei dati |
Consulta ciascuna sezione dei moduli sopra per la documentazione dettagliata degli endpoint con parametri e descrizioni.
Analisi di progetto basata sull'AI che valuta il tuo progetto in 9 domini ponderati e genera un punteggio di completezza da 0 a 100 (con voti da A a F).
API: GET /api/v1/project_intelligence/score/?project_id=X - restituisce il punteggio complessivo, i punteggi per dominio, le lacune critiche e i traguardi.
Gestisci i membri del team, i ruoli e il controllo degli accessi per modulo.
Gli amministratori possono configurare la visibilità dei moduli e i livelli di accesso per utente (Nessuno, Visualizzazione, Modifica, Completo) tramite la pagina /users. È possibile assegnare nomi di ruolo personalizzati (ad es. "Ingegnere di cantiere", "Cost Manager").
Metti una stella al repository per aiutare gli altri a scoprire il progetto.
Iscriviti per guide alle release e tutorial. Inizia con la panoramica del prodotto di 12 minuti.
Apri una issue su GitHub.
Unisciti alla community Telegram per fare domande.
Contattaci per il deployment e la formazione.
Licenza: AGPL-3.0. Licenze commerciali: info@datadrivenconstruction.io
OpenConstructionERP
Realizzato dal team DataDrivenConstruction
2026 Data Driven Construction. AGPL-3.0
Commenti
Sistema di commenti a thread che può essere associato a qualsiasi entità della piattaforma - posizioni BOQ, attività, RFI, submittal, documenti, ispezioni e altro ancora. Supporta le @menzioni per notificare i membri del team, gli allegati di file e il monitoraggio della risoluzione per discussioni orientate all'azione.
Funzionalità principali
Endpoint API
/api/v1/comments/?entity_type=task&entity_id=.../api/v1/comments//api/v1/comments/{id}/reply/api/v1/comments/{id}/resolve