Version 1

Author: MarouaneBenbrahim

.env.example

@@ -0,0 +1,215 @@
+# Manhattan Power Grid - Environment Configuration Template
+# Copy this file to .env and update with your settings
+
+# =============================================================================
+# Flask Application Settings
+# =============================================================================
+
+# Environment: development, production, testing
+FLASK_ENV=development
+
+# Enable debug mode (set to False in production)
+FLASK_DEBUG=True
+
+# Secret key for session management (generate a secure key for production)
+SECRET_KEY=your-secret-key-here-change-in-production
+
+# Application host and port
+FLASK_HOST=0.0.0.0
+FLASK_PORT=5000
+
+# =============================================================================
+# Database Configuration
+# =============================================================================
+
+# Database URL (SQLite for development, PostgreSQL for production)
+DATABASE_URL=sqlite:///manhattan_grid.db
+
+# Production PostgreSQL example:
+# DATABASE_URL=postgresql://username:password@localhost:5432/manhattan_grid
+
+# Database connection pool settings
+DB_POOL_SIZE=10
+DB_MAX_OVERFLOW=20
+
+# =============================================================================
+# SUMO Traffic Simulation
+# =============================================================================
+
+# SUMO installation directory (required for vehicle simulation)
+SUMO_HOME=/path/to/sumo
+
+# Windows example:
+# SUMO_HOME=C:\Program Files (x86)\Eclipse\Sumo
+
+# Linux example:
+# SUMO_HOME=/usr/share/sumo
+
+# macOS example:
+# SUMO_HOME=/opt/homebrew/share/sumo
+
+# SUMO configuration
+SUMO_GUI=False
+SUMO_STEP_LENGTH=1.0
+SUMO_BEGIN_TIME=0
+SUMO_END_TIME=3600
+
+# =============================================================================
+# Power Grid Simulation
+# =============================================================================
+
+# Grid update interval (seconds)
+GRID_UPDATE_INTERVAL=5
+
+# Power flow analysis settings
+POWER_FLOW_SOLVER=pandapower
+VOLTAGE_TOLERANCE=0.05
+FREQUENCY_TOLERANCE=0.1
+
+# =============================================================================
+# Vehicle-to-Grid (V2G) Settings
+# =============================================================================
+
+# V2G system enable/disable
+V2G_ENABLED=True
+
+# Default V2G power rating per vehicle (kW)
+V2G_POWER_RATING=250
+
+# Energy pricing ($/kWh)
+V2G_ENERGY_PRICE=0.15
+
+# V2G activation threshold (percentage of substation capacity)
+V2G_ACTIVATION_THRESHOLD=90
+
+# =============================================================================
+# Machine Learning & AI
+# =============================================================================
+
+# OpenAI API key for AI chatbot (optional)
+OPENAI_API_KEY=your-openai-api-key-here
+
+# OpenAI model configuration
+OPENAI_MODEL=gpt-3.5-turbo
+OPENAI_MAX_TOKENS=1000
+OPENAI_TEMPERATURE=0.7
+
+# ML model training settings
+ML_RETRAIN_INTERVAL=3600
+ML_BATCH_SIZE=32
+ML_LEARNING_RATE=0.001
+
+# =============================================================================
+# External Services
+# =============================================================================
+
+# Mapbox access token for enhanced mapping (optional)
+MAPBOX_ACCESS_TOKEN=your-mapbox-token-here
+
+# Weather API configuration (optional)
+WEATHER_API_KEY=your-weather-api-key
+WEATHER_UPDATE_INTERVAL=1800
+
+# =============================================================================
+# Logging Configuration
+# =============================================================================
+
+# Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL
+LOG_LEVEL=INFO
+
+# Log file location
+LOG_FILE=logs/manhattan_grid.log
+
+# Log rotation settings
+LOG_MAX_BYTES=10485760
+LOG_BACKUP_COUNT=5
+
+# Structured logging format
+LOG_FORMAT=json
+
+# =============================================================================
+# Security Settings
+# =============================================================================
+
+# CORS allowed origins (comma-separated)
+CORS_ORIGINS=http://localhost:3000,http://localhost:5000
+
+# API rate limiting
+RATE_LIMIT_ENABLED=True
+RATE_LIMIT_PER_MINUTE=60
+RATE_LIMIT_PER_HOUR=1000
+
+# Session timeout (seconds)
+SESSION_TIMEOUT=3600
+
+# =============================================================================
+# Performance Settings
+# =============================================================================
+
+# Enable caching
+CACHE_ENABLED=True
+CACHE_TYPE=simple
+CACHE_DEFAULT_TIMEOUT=300
+
+# Background task settings
+CELERY_BROKER_URL=redis://localhost:6379/0
+CELERY_RESULT_BACKEND=redis://localhost:6379/0
+
+# =============================================================================
+# Development Settings
+# =============================================================================
+
+# Enable profiling (development only)
+PROFILING_ENABLED=False
+
+# Mock external services (for testing)
+MOCK_SUMO=False
+MOCK_WEATHER=False
+MOCK_OPENAI=False
+
+# =============================================================================
+# Monitoring & Metrics
+# =============================================================================
+
+# Enable metrics collection
+METRICS_ENABLED=True
+
+# Metrics export interval (seconds)
+METRICS_EXPORT_INTERVAL=60
+
+# Health check endpoint
+HEALTH_CHECK_ENABLED=True
+
+# =============================================================================
+# Backup & Recovery
+# =============================================================================
+
+# Database backup settings
+BACKUP_ENABLED=True
+BACKUP_INTERVAL=86400
+BACKUP_RETENTION_DAYS=30
+BACKUP_LOCATION=backups/
+
+# =============================================================================
+# Deployment Settings
+# =============================================================================
+
+# Environment identifier
+ENVIRONMENT=development
+
+# Application version (auto-populated by CI/CD)
+APP_VERSION=2.0.0
+
+# Build information
+BUILD_ID=local
+BUILD_DATE=2025-01-15
+
+# =============================================================================
+# Feature Flags
+# =============================================================================
+
+# Enable experimental features
+FEATURE_ADVANCED_ML=False
+FEATURE_BLOCKCHAIN_TRADING=False
+FEATURE_IOT_INTEGRATION=False
+FEATURE_MULTI_CITY=False

.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,89 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: 'bug'
+assignees: ''
+---
+
+## 🐛 Bug Description
+
+A clear and concise description of what the bug is.
+
+## 🔄 Steps to Reproduce
+
+1. Go to '...'
+2. Click on '...'
+3. Scroll down to '...'
+4. See error
+
+## ✅ Expected Behavior
+
+A clear and concise description of what you expected to happen.
+
+## ❌ Actual Behavior
+
+A clear and concise description of what actually happened.
+
+## 📸 Screenshots
+
+If applicable, add screenshots to help explain your problem.
+
+## 🖥️ Environment
+
+**Desktop:**
+- OS: [e.g. Windows 10, macOS 12.0, Ubuntu 20.04]
+- Browser: [e.g. Chrome 96, Firefox 95, Safari 15]
+- Python Version: [e.g. 3.8.10]
+- SUMO Version: [e.g. 1.15.0]
+
+**Server/Backend:**
+- Python Version: [e.g. 3.8.10]
+- Flask Version: [e.g. 2.3.3]
+- Database: [e.g. PostgreSQL 13]
+
+## 📋 Package Versions
+
+Please run `pip freeze` and paste the output here:
+
+```
+Flask==2.3.3
+numpy==1.26.4
+...
+```
+
+## 📊 System Logs
+
+If applicable, add relevant log outputs:
+
+**Application Logs:**
+```
+[2025-01-15 10:30:00] ERROR: ...
+```
+
+**Browser Console:**
+```
+Error: ...
+```
+
+**SUMO Logs:**
+```
+Warning: ...
+```
+
+## 🔍 Additional Context
+
+Add any other context about the problem here:
+
+- When did this start happening?
+- Does it happen consistently or intermittently?
+- Have you made any recent changes to your setup?
+- Are there any workarounds you've found?
+
+## ✅ Checklist
+
+- [ ] I have searched existing issues to make sure this is not a duplicate
+- [ ] I have provided all requested environment information
+- [ ] I have included relevant logs and error messages
+- [ ] I have tested this with the latest version
+- [ ] I have provided clear steps to reproduce the issue