An AI-powered project intelligence system for hyperscale data centre EPC delivery. The platform connects specifications, vendor submittals, procurement records, schedules, RFIs, commissioning documents, and quality records into a single operational intelligence layer.
Built for data centre construction teams targeting Tier III and Tier IV quality standards.
| Module | Description |
|---|---|
| Documents | Upload, chunk, embed, and semantic search over project corpus |
| RFI Copilot | RAG + Groq chat with citations and similar-RFI detection |
| Spec Compliance | Submittal checking, NC audit trail, golden tests |
| Schedule Risk | Critical-path risk identification with mitigation options |
| Supply Chain | Shipment visibility and delivery risk alerts |
| Commissioning | Guided testing against TIA-942 / Uptime Tier standards |
- Frontend: Next.js, TypeScript, Tailwind CSS
- Backend: FastAPI, SQLAlchemy
- Database: PostgreSQL (Docker) or SQLite (local fallback)
- Document intelligence: PyMuPDF, ChromaDB, sentence-transformers (local embeddings)
- AI (planned): Groq LLM for RAG agents
See docs/SETUP.md for full installation instructions.
- Node.js 20+
- Python 3.11+
- Docker Desktop (for PostgreSQL)
# 1. Start database
docker compose up -d
# 2. Backend
cd backend
copy .env.example .env
python -m venv .venv
.\.venv\Scripts\pip install -r requirements.txt
.\.venv\Scripts\uvicorn app.main:app --reload --port 8000
# 3. Frontend (new terminal)
cd frontend
npm install
npm run devOpen http://localhost:3000 and use Seed Demo Project to load the sample project and document corpus (23+ specs, RFIs, change orders, commissioning procedures).
Documents page: upload PDF/Markdown files and run vector search (e.g. "UPS battery runtime").
API documentation: http://localhost:8000/docs
Set GROQ_API_KEY in backend/.env for full AI-generated RFI answers (fallback RAG mode works without it).
RFI Copilot (/rfi): ask questions with citations and similar resolved RFIs.
Spec Compliance (/compliance): upload vendor submittals from data/submittals/ to flag non-conformances.
Run golden compliance tests:
cd backend
.\.venv\Scripts\python scripts\run_golden_tests.pycd backend
.\.venv\Scripts\python scripts\seed_corpus.pyfrontend/ Web application
backend/ REST API and data models
data/ Project documents and test fixtures
docs/ Setup and architecture documentation
docker-compose.yml PostgreSQL service (host port 5433)
MIT — see LICENSE