Enterprise grade open source smart city management platform. A complete modular system for operating an entire modern city with real-time monitoring, automation, and cross-domain optimization.
# Clone repository
git clone https://github.com/PhillipC05/TPT-SmartCity.git
cd TPT-SmartCity
# Install dependencies
npm install
npm run services:install
# Copy environment configuration
cp .env.example .env
# Generate JWT keys (RS256)
mkdir -p keys
openssl genrsa -out keys/private.pem 2048
openssl rsa -in keys/private.pem -pubout -out keys/public.pem
# Initialize database
npm run db:init
# Start development environment
npm run devAccess the platform at:
- Dashboard: http://localhost:8080
- API Gateway: http://localhost:3000
- Digital Twin: http://localhost:8081
# Run integration tests
npm test
# Run security audit
node deployment/security-audit.js
# Run load tests
npm --prefix simulation run test:load| Module | Status |
|---|---|
| Traffic Management & Intelligent Transportation | ✅ Ready |
| Energy Monitoring & Grid Optimization | ✅ Ready |
| Public Utility Management (Water, Waste, Lighting) | ✅ Ready |
| Citizen Engagement & Service Request Portal | ✅ Ready |
| Public Safety & Emergency Management | ✅ Ready |
| Environmental Monitoring | ✅ Ready |
| 3D City Digital Twin | ✅ Ready |
| Cross-Domain AI Orchestration Engine | ✅ Ready |
| Predictive Failure Prevention | ✅ Ready |
| Equity & Fairness Auditing | ✅ Ready |
| Privacy First Zero Trust Architecture | ✅ Ready |
| Prometheus Metrics & Grafana Dashboards | ✅ Ready |
| Structured Error Tracking (Sentry) | ✅ Ready |
| Method | Instructions |
|---|---|
| Local Development | Getting Started Guide |
| Docker Deployment | docker compose up -d |
| Production | Production Deployment Guide |
| Cloud AWS/Azure/GCP | Cloud Deployment Guide |
| Kubernetes / Helm | Deployment Guide |
tpt-smart-city/
├── docs/ # Architecture & Design Documents
├── frontend/ # Administration Dashboard & Citizen Portal
├── backend/ # Core API Gateway
├── services/
│ ├── traffic-service/ # Traffic management & intelligent transportation
│ ├── energy-service/ # Energy monitoring & grid optimization
│ ├── environment-service/ # Environmental monitoring (air quality, weather, noise)
│ ├── safety-service/ # Public safety & emergency management
│ ├── water-service/ # Water quality & consumption monitoring
│ └── orchestrator/ # Cross-Domain AI Orchestration Engine
├── citizen-portal/ # Citizen engagement & service request portal
├── digital-twin/ # 3D City Digital Twin Engine
├── simulation/ # City Systems Simulator & Load Testing
├── shared/ # Shared middleware, DB connection, health checks, metrics
├── database/ # Schema, partitioning, data retention scripts
├── deployment/ # Docker, Kubernetes, Helm, Terraform, Monitoring
└── tests/ # Integration & end-to-end tests
- Authentication: RS256 asymmetric JWT with RSA 2048-bit keys
- Authorization: JWT-based auth middleware on all microservices
- Rate Limiting: express-rate-limit on gateway and all services
- Input Validation: Joi schema validation on all POST/PUT endpoints
- Error Handling: Centralized error handler — no database error code leakage
- SQL Injection Prevention: Parameterized queries throughout
- Data Privacy: No sensitive data exposure in API responses
- Security Audit:
node deployment/security-audit.js
| Tool | Purpose | Access |
|---|---|---|
| Prometheus | Metrics collection (all services expose /metrics) |
http://localhost:9090 |
| Grafana | Dashboards & visualization (auto-provisioned) | http://localhost:3001 |
| Sentry | Error tracking (opt-in via SENTRY_DSN) |
External |
| Health Endpoints | /health, /health/live, /health/ready on all services |
Per service |
This project is licensed under the MIT License — see the LICENSE file for details.
- Containers: Docker Compose (dev), Docker Swarm / Kubernetes (prod)
- Kubernetes: Manifests under
deployment/kubernetes/ - Helm: Chart under
deployment/helm/ - Terraform: Infrastructure-as-Code under
deployment/terraform/ - Database: PostgreSQL with monthly partitioning, automated retention
- Caching: Redis (optional, configured via
REDIS_URL)