Skip to content

VDP89/ergon-demo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DG Ingenieria

ERGON

AI-Powered Construction Intelligence Platform
12 views. 4,800+ lines. 1 engineer. Zero dependencies.

Built with Claude Python 3.10+ HTML5 MIT License

Zero pip dependencies 12 Views 4800+ lines EVM


What is ERGON?

ERGON is a standalone construction project oversight platform built as a single HTML file with an optional Python server for AI-powered analysis. It gives project stakeholders (investors, managers, site supervisors) real-time visibility into construction progress, budget, risks, and workforce — all from a browser.

No frameworks. No build tools. No npm install. Just open the file.

Designed and built by a single engineer using Claude as a development partner, ERGON demonstrates what's possible when domain expertise meets AI-native software development.

Features

12 Interactive Views

# View Purpose
1 Dashboard Executive KPIs: progress %, budget status, workforce, alerts
2 Progress (Avance) Physical progress tracking with S-curve (Earned Value)
3 Budget (Presupuesto) Cost control: planned vs actual, deviation analysis
4 Alerts (Alertas) Risk matrix with severity, owner, and deadline
5 Weather (Clima) Weather impact tracking on construction schedule
6 Schedule (Cronograma) Gantt chart with baseline comparison and critical path
7 Contractors (Contratistas) Subcontractor performance: progress, cost, compliance
8 Attendance (Asistencia) Daily workforce tracking with notes
9 Photos (Fotos) Site photo documentation with timeline
10 Daily Log Structured daily construction reports
11 BIM Viewer IFC model viewer (Three.js + web-ifc)
12 Documents (Documentos) Document management and version control

Technical Highlights

  • Earned Value Management (EVM): Full CPI/SPI calculations with S-curve visualization
  • AI Agent Panel: Optional Claude integration for natural-language queries about project data
  • Voice Input: Web Speech API for hands-free daily log entries (Spanish-Paraguay)
  • PDF Export: Client-side report generation via jsPDF
  • BIM Integration: IFC file viewer with element tree, properties, and 3D navigation
  • Zero Dependencies: Server runs on Python stdlib only — no pip install required
  • Responsive Design: DG Design System (Slate/Cream palette, Inter font, SVG icons)

Quick Start

Option 1: Just open it

# Double-click index.html — that's it

Option 2: With AI agent (optional)

# Set your Anthropic API key
set ANTHROPIC_API_KEY=sk-ant-...    # Windows
export ANTHROPIC_API_KEY=sk-ant-... # Linux/Mac

# Start the server (zero pip dependencies)
python server.py

# Open http://localhost:8080 in your browser

Architecture

ergon-demo/
├── index.html       # 4,800+ lines — the entire platform in one file
├── server.py        # Python stdlib server + Claude API proxy
├── jspdf.umd.min.js # PDF export library
├── assets/
│   ├── logo_dg_color.png
│   └── logo_dg_blanco.png
├── screenshots/     # Dashboard screenshots
├── LICENSE          # MIT
└── README.md

Design Decisions

Decision Rationale
Single HTML file Portability — runs anywhere, even offline
No build tools Zero friction for construction professionals
Python stdlib server Works on any machine with Python installed
Client-side PDF No server needed for report generation
Web Speech API Voice notes on construction sites (noisy environments)

Context

ERGON was built as the technology layer for a construction oversight service in Asuncion, Paraguay. The target market is residential tower developments ($2-15M projects) where investors need real-time visibility into progress, budget, and risks.

The platform was developed by a single engineer (civil + software) using Claude as a pair programmer — demonstrating the 1 human + AI model for building production-grade domain software.

Stack

  • Frontend: Vanilla HTML5 + CSS3 + JavaScript (no React, no Vue, no Angular)
  • Charts: Canvas 2D API (no Chart.js, no D3)
  • 3D/BIM: Three.js + web-ifc (CDN)
  • Backend: Python 3.10+ (stdlib only)
  • AI: Anthropic Claude API (optional)
  • Design: Custom design system (DG Palette)

Screenshots

Dashboard — Executive Overview

Dashboard

Progress Tracking — S-Curve & EVM

S-Curve

Schedule — Gantt Chart

Gantt

Daily Log — Voice-Enabled Field Reports

Daily Log

About DG Ingenieria

DG Ingenieria SRL is a one-person engineering firm in Paraguay building AI-native tools for infrastructure: construction oversight (ERGON), aeronautical calculations (SkyPathPro), road design (MARCO), and pavement analysis.

Model: 1 engineer + AI = capacity of 10-15.

License

MIT License. See LICENSE.


Built in Asuncion, Paraguay with Claude

About

AI-Powered Construction Intelligence Platform. 12 views, 4800+ lines, zero dependencies. Built with Claude.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors