Process Engineering Suite

A monorepo for process engineering calculations and workflows.

Apps

App	Port	Description
apps/web	3000	Dashboard
apps/docs	3001	Documentation site
apps/network-editor	3002	Hydraulic network editor
apps/psv	3003	PSV sizing workflow
apps/design-agents	3004	AI design agents
apps/venting-calculation	3005	Tank venting calculator

Backend

Service	Port	Description
services/api	8000	FastAPI REST API
services/calc-engine	-	Python calculation engine

Quick Start

Docker (Recommended)

# 1. Set PostgreSQL password
cd infra
echo "POSTGRES_PASSWORD=change-me" > .env

# 2. Start all services
docker compose up -d --build

# 3. Open in browser
open http://localhost:3000      # Dashboard
open http://localhost:8000/docs # API docs

Local Development (Bun)

# Install dependencies
bun install

# Run all apps
bun run dev

Common Commands

bun run build        # Build all apps
bun run lint         # Lint code
bun run check-types  # Type check
bun run format       # Format code

Project Structure

apps/           # Frontend applications (Next.js / Vite)
├── web/
├── docs/
├── network-editor/
├── psv/
├── design-agents/
└── venting-calculation/

services/       # Backend services (Python)
├── api/        # FastAPI REST API (with design-agents logic)
└── calc-engine/

packages/       # Shared libraries
├── api-client/ # Generated API client
├── api-std/    # Standard API definitions
├── physics-engine/ # Calculation logic
├── ui-kit/     # Shared UI components
├── types/      # Shared TypeScript types
├── unit-converter/ # Unit conversion utility
└── ...

infra/          # Docker & deployment config
docs/           # Architecture documentation

Documentation

• DEVELOPING.md - Setup guides
• docs/ENVIRONMENT_VARIABLES.md - Environment variables
• docs/DATABASE_SCHEMA.md - Database schema
• AGENTS.md - Code conventions

Tech Stack

• Frontend: Next.js, Vite, TypeScript, Tailwind, Bun, Material UI
• Backend: Python, FastAPI, SQLAlchemy, Alembic, LangGraph
• Database: PostgreSQL
• Deployment: Docker, Vercel