Sync up of many additions, incl. documentation and new sample apps

.env

@@ -1,7 +1,103 @@
+# Neuroglia Python Framework - Environment Configuration
+# This file contains shared configuration for all sample applications
+
+# ============================================================================
+# Python & Development Settings
+# ============================================================================
+
 PYTHONPATH=./src
 PYDEVD_DISABLE_FILE_VALIDATION=1
-LOG_LEVEL="DEBUG"
-CONSUMER_GROUP="reporter"
-CLOUD_EVENT_SINK="http://event-player/events/pub"
-CLOUD_EVENT_SOURCE="http://certs-insights.ccie.cisco.com"
-CLOUD_EVENT_TYPE_PREFIX="com.cisco.certs-insights"
+LOG_LEVEL=DEBUG
+
+# ============================================================================
+# Documentation Settings
+# ============================================================================
+
+DOCS_SITE_NAME="Neuroglia Python Framework"
+DOCS_SITE_URL="https://bvandewe.github.io/pyneuro/"
+DOCS_FOLDER=./docs
+DOCS_DEV_PORT=8000
+
+# ============================================================================
+# Shared Infrastructure Ports
+# ============================================================================
+
+# Database
+MONGODB_PORT=27017
+MONGODB_EXPRESS_PORT=8081
+
+# Authentication
+KEYCLOAK_PORT=8090
+
+# Observability
+GRAFANA_PORT=3001
+PROMETHEUS_PORT=9090
+TEMPO_PORT=3200
+LOKI_PORT=3100
+OTEL_COLLECTOR_GRPC_PORT=4417
+OTEL_COLLECTOR_HTTP_PORT=4418
+OTEL_COLLECTOR_METRICS_PORT=8988
+OTEL_COLLECTOR_HEALTH_PORT=13233
+
+# Event Management
+EVENT_PLAYER_PORT=8085
+
+# ============================================================================
+# Sample Application Ports
+# ============================================================================
+
+# Mario's Pizzeria
+MARIO_PORT=8080
+MARIO_DEBUG_PORT=5778
+
+# Simple UI
+SIMPLE_UI_PORT=8082
+SIMPLE_UI_DEBUG_PORT=5779
+
+# ============================================================================
+# Database Credentials
+# ============================================================================
+
+MONGODB_ROOT_USERNAME=root
+MONGODB_ROOT_PASSWORD=neuroglia123
+MONGODB_DATABASE=neuroglia
+
+# ============================================================================
+# Keycloak Configuration
+# ============================================================================
+
+KEYCLOAK_ADMIN_USERNAME=admin
+KEYCLOAK_ADMIN_PASSWORD=admin
+KEYCLOAK_REALM=pyneuro
+KEYCLOAK_DB_VENDOR=h2
+
+# ============================================================================
+# Observability Configuration
+# ============================================================================
+
+OTEL_SERVICE_NAME_MARIO=mario-pizzeria
+OTEL_SERVICE_NAME_SIMPLE_UI=simple-ui
+OTEL_SERVICE_VERSION=1.0.0
+
+# ============================================================================
+# Application Configuration
+# ============================================================================
+
+ENABLE_CORS=true
+LOCAL_DEV=true
+DATA_DIR=./data
+
+# ============================================================================
+# Docker Network
+# ============================================================================
+
+DOCKER_NETWORK_NAME=pyneuro-net
+
+# ============================================================================
+# CloudEvents Configuration (for samples)
+# ============================================================================
+
+CONSUMER_GROUP=reporter
+CLOUD_EVENT_SINK=http://event-player:8080/events/pub
+CLOUD_EVENT_SOURCE=http://myawesomeapp.com
+CLOUD_EVENT_TYPE_PREFIX=com.myawesomeapp

.env.sample

@@ -0,0 +1,15 @@
+PYTHONPATH=./src
+PYDEVD_DISABLE_FILE_VALIDATION=1
+LOG_LEVEL="DEBUG"
+
+# Documentation settings
+DOCS_SITE_NAME="Neuroglia Python Framework"
+DOCS_SITE_URL="https://bvandewe.github.io/pyneuro/"
+DOCS_FOLDER=./docs
+DOCS_DEV_PORT=8000
+
+# pyneuro samples
+CONSUMER_GROUP="reporter"
+CLOUD_EVENT_SINK="http://event-player/events/pub"
+CLOUD_EVENT_SOURCE="http://myawesomeapp.com"
+CLOUD_EVENT_TYPE_PREFIX="com.myawesomeapp"