TPT Infrastructure Engineer

An end-to-end infrastructure engineering platform for project management, cost estimation, scheduling, CAD/BIM workflows, and real-time collaboration. Built for civil engineers, project managers, quantity surveyors, and contractors.

Features

Module	Description
Project Workspace	CRUD, version control, activity feed, file attachments, commenting
2D Drawing Board	Fabric.js canvas with snapping, dimensioning, layers, annotations
3D Scene Viewer	Three.js + web-ifc viewer with orbit controls and IFC/BIM model support
AI Design Generator	Parametric templates with scored structural alternatives
Design Comparison	Side-by-side cost, structural and carbon comparison
DXF / IFC Importer	Import AutoCAD DXF drawings and IFC BIM models
Materials Database	AS/NZS-rated library with regional pricing, supplier info, carbon tracking
Cost Estimator	Quantity take-off, overhead/profit, contingency, escalation
CPM Scheduler	Gantt chart, critical path, resource levelling, milestone tracking
Feasibility Engine	Geotechnical, environmental, hydrological, traffic analysis
Risk Analysis	Risk register, Monte Carlo simulation, mitigation planning
Report Generator	PDF/Excel/Word export with approval workflow
Procurement	BOM, tender packages, purchase orders, supplier comparison
Carbon Dashboard	Scope 1/2/3 emissions breakdown and benchmark comparison
Compliance Checker	Validate designs against AS/NZS structural and environmental standards
AI Assistant	Rule-based Q&A; LLM-powered when `AI_ENABLED=true`
Real-time Collaboration	WebSocket presence, live cursors, document locking
Role-based Access	Owner, Engineer, PM, Surveyor, Draftsman, Contractor, Supplier, Viewer
Audit Trail	Full create/update/delete audit log per organisation
i18n	English and Māori (te reo) translations

Tech Stack

Layer	Technology
Frontend	React 19, TypeScript, Tailwind CSS v4, Vite
Drawing	Fabric.js v7
3D / BIM	Three.js r170 + web-ifc-three
Charts	Recharts
State	Zustand + TanStack Query
Backend	FastAPI, Python 3.12
Database	PostgreSQL 16 + PostGIS 3.4
ORM	SQLAlchemy 2 + GeoAlchemy2
Auth	JWT HS256 (python-jose) + bcrypt
Calculations	NumPy + SciPy
GIS	GeoPandas + Shapely
Containers	Docker + docker-compose
CI/CD	GitHub Actions

Quick Start

Prerequisites

Python 3.12+
Node.js 20+
PostgreSQL 16 with PostGIS 3.4

1. Clone and configure

git clone https://github.com/PhillipC05/tpt-infrastructure-engineer.git
cd tpt-infrastructure-engineer
cp backend/.env.example backend/.env
# Edit backend/.env — set SECRET_KEY to a random 64-char hex string:
# python -c "import secrets; print(secrets.token_hex(32))"

2. Database setup

# Create the database
psql -U postgres -c "CREATE DATABASE tpt_infrastructure;"
psql -U postgres -c "CREATE EXTENSION postgis;" -d tpt_infrastructure

# Apply migrations
cd backend
alembic upgrade head

3. Backend

cd backend
pip install -r requirements.txt
uvicorn main:app --reload

API: http://localhost:8000 — Interactive docs: http://localhost:8000/docs

4. Frontend

cd frontend
npm install
npm run dev

App: http://localhost:5173

5. Docker (full stack)

cp backend/.env.example backend/.env   # fill in credentials
docker-compose up --build

Project Structure

tpt-infrastructure-engineer/
├── backend/
│   ├── main.py              API endpoints + WebSocket
│   ├── auth.py              JWT authentication
│   ├── models.py            SQLAlchemy ORM models
│   ├── schemas.py           Pydantic request/response schemas
│   ├── database.py          DB engine + session factory
│   ├── audit_logger.py      Audit trail
│   ├── websocket_manager.py Real-time connection manager
│   ├── compliance.py        AS/NZS compliance rules
│   ├── anomaly.py           Cost anomaly detection
│   ├── integrations.py      AI + GIS + IoT integrations
│   ├── estimation.py        Cost estimation engine
│   ├── feasibility.py       Feasibility assessment engine
│   ├── scheduling.py        CPM scheduler (NetworkX)
│   ├── procurement.py       Procurement workflow
│   ├── reporting.py         Report generator
│   ├── materials.py         Materials database
│   └── middleware/          Security, logging, transaction middleware
├── frontend/src/
│   ├── App.tsx              Routes + layout
│   ├── pages/               Feature pages (Dashboard, Projects, etc.)
│   ├── components/          Shared UI + drawing/3D components
│   ├── store/               Zustand auth store
│   ├── lib/                 API client, i18n, utilities
│   └── providers/           React context providers
├── tests/                   pytest test suite (SQLite in-memory)
├── alembic/                 Database migrations
├── docs/                    Deployment and runbook docs
├── docker-compose.yml
└── Dockerfile

Environment Variables

Copy backend/.env.example to backend/.env and configure:

Variable	Required	Description
`SECRET_KEY`	Yes	64-char random hex for JWT signing
`DATABASE_URL`	No	PostgreSQL connection string (default: localhost)
`TPT_TOKEN_EXPIRE_MINUTES`	No	JWT expiry in minutes (default: 480)
`CORS_ORIGINS`	No	Comma-separated allowed origins
`ALLOWED_HOSTS`	No	Comma-separated trusted hosts
`AI_ENABLED`	No	`true` to enable LLM-powered assistant
`SMTP_HOST`	No	SMTP server for email notifications

For the frontend, copy frontend/.env.example to frontend/.env:

Variable	Required	Description
`VITE_API_URL`	No	Backend URL (default: `http://localhost:8000`)

Running Tests

cd backend
python -m pytest ../tests/ -v

# Load testing
cd tests/load_testing
locust -f locustfile.py

API Documentation

FastAPI generates interactive Swagger UI at /docs and ReDoc at /redoc automatically when the backend is running.

Innovative Roadmap

Planned for future releases:

PWA / Offline Mode — service worker so field engineers can annotate without connectivity
Live Materials Pricing — supplier price feed integration for real-time unit rates
Drone Survey Import — LAS/LAZ point cloud to 3D mesh pipeline
Digital Twin Sync — push design changes to IoT sensor networks
QR Site Signs — one-click printable QR-coded project information boards

tpt-infrastructure-engineer

Languages