Implement GUI Demo Mode and Create Wiki

GUI Demo Mode:
- Added backend/core-orbits/app/services/demo.py: Reusable demo seed service
- Added backend/core-orbits/app/demo_routes.py: API endpoint for seeding
- Updated backend/common/config.py: Added DEMO_MODE
- Updated frontend/web/src/pages/Login.tsx: New Login page with Demo controls
- Updated frontend/web/src/api/client.ts: Added auth interceptor and demo methods
- Updated frontend/web/src/App.tsx: Added /login route
- Updated frontend/web/src/components/Layout.tsx: Added User/Login access

Wiki Documentation:
- Created wiki/ directory with comprehensive docs:
  - Home.md, Getting-Started.md, Architecture.md
  - Security.md, User-Guide.md, Limitations.md, Development.md

Author: TamTunnel

backend/common/config.py

@@ -26,7 +26,10 @@ class Settings(BaseSettings):
     auth_disabled: bool = False  # Set True for local dev without auth
     jwt_secret_key: str = "change-me-in-production-use-a-real-secret-key"
     jwt_algorithm: str = "HS256"
-    jwt_expire_minutes: int = 60
+    jwt_expire_minutes: int = 60 * 24  # 24 hours
+    
+    # Demo Mode
+    demo_mode: bool = True
     admin_api_key: str = ""  # Optional API key for service-to-service calls
 
     # AI/LLM

backend/core-orbits/app/demo_routes.py

@@ -0,0 +1,32 @@
+"""
+Demo Routes.
+
+Provides endpoints for demo setup and management.
+"""
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from .db import get_db
+from common.config import get_settings
+from .services.demo import seed_demo_data
+
+router = APIRouter(prefix="/demo", tags=["Demo"])
+
+@router.post("/seed", status_code=201)
+async def seed_demo(
+    db: AsyncSession = Depends(get_db),
+    settings = Depends(get_settings)
+):
+    """
+    Seed the database with demo data.
+    
+    Only available if DEMO_MODE is enabled.
+    """
+    if not settings.demo_mode:
+        raise HTTPException(status_code=403, detail="Demo mode is disabled")
+        
+    try:
+        result = await seed_demo_data(db)
+        return result
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))

backend/core-orbits/app/main.py

@@ -12,6 +12,7 @@
 sys.path.insert(0, str(__file__).replace('/core-orbits/app/main.py', ''))
 
 from .routes import router
+from .demo_routes import router as demo_router
 from .db import init_db, get_db
 
 # Import from common module
@@ -82,6 +83,7 @@ async def request_id_middleware(request: Request, call_next):
 
 # Include main routes
 app.include_router(router)
+app.include_router(demo_router)
 
 # Include TLE routes
 try:

backend/core-orbits/app/services/demo.py

@@ -0,0 +1,175 @@
+"""
+Demo Data Service.
+
+Provides functionality to seed the database with demo data.
+"""
+from sqlalchemy import text
+from sqlalchemy.ext.asyncio import AsyncSession
+from common.auth import hash_password
+from common.logger import get_logger
+
+logger = get_logger("demo-service")
+
+# Sample TLE data (ISS and Starlink samples)
+DEMO_TLES = [
+    {
+        "name": "ISS (ZARYA)",
+        "norad_id": "25544",
+        "tle1": "1 25544U 98067A   24001.50000000  .00016717  00000-0  10270-3 0  9021",
+        "tle2": "2 25544  51.6400 208.9163 0006703 280.7808  79.2154 15.49815776    29",
+    },
+    {
+        "name": "STARLINK-1007",
+        "norad_id": "44713",
+        "tle1": "1 44713U 19074A   24001.50000000  .00001234  00000-0  98765-4 0  9012",
+        "tle2": "2 44713  53.0000 120.0000 0001500 100.0000 260.0000 15.06000000123456",
+    },
+    {
+        "name": "STARLINK-1008",
+        "norad_id": "44714",
+        "tle1": "1 44714U 19074B   24001.50000000  .00001234  00000-0  98765-4 0  9013",
+        "tle2": "2 44714  53.0000 121.0000 0001500 101.0000 259.0000 15.06000000123457",
+    },
+    {
+        "name": "STARLINK-1009",
+        "norad_id": "44715",
+        "tle1": "1 44715U 19074C   24001.50000000  .00001234  00000-0  98765-4 0  9014",
+        "tle2": "2 44715  53.0000 122.0000 0001500 102.0000 258.0000 15.06000000123458",
+    },
+    {
+        "name": "STARLINK-1010",
+        "norad_id": "44716",
+        "tle1": "1 44716U 19074D   24001.50000000  .00001234  00000-0  98765-4 0  9015",
+        "tle2": "2 44716  53.0000 123.0000 0001500 103.0000 257.0000 15.06000000123459",
+    },
+    {
+        "name": "STARLINK-1011",
+        "norad_id": "44717",
+        "tle1": "1 44717U 19074E   24001.50000000  .00001234  00000-0  98765-4 0  9016",
+        "tle2": "2 44717  53.0000 124.0000 0001500 104.0000 256.0000 15.06000000123460",
+    },
+]
+
+GROUND_STATIONS = [
+    {
+        "name": "AWS Ground Station - US West",
+        "latitude": 37.7749,
+        "longitude": -122.4194,
+        "elevation_m": 50,
+        "min_elevation_deg": 10.0,
+    },
+    {
+        "name": "ESA Ground Station - Europe",
+        "latitude": 52.2985,
+        "longitude": 5.1719,
+        "elevation_m": 100,
+        "min_elevation_deg": 10.0,
+    },
+    {
+        "name": "JAXA Ground Station - Asia",
+        "latitude": 35.6762,
+        "longitude": 139.6503,
+        "elevation_m": 20,
+        "min_elevation_deg": 10.0,
+    },
+]
+
+DEMO_USERS = [
+    {
+        "username": "demo_viewer",
+        "email": "viewer@demo.constellation-hub.local",
+        "password": "viewer123",
+        "full_name": "Demo Viewer",
+        "role": "viewer",
+    },
+    {
+        "username": "demo_ops",
+        "email": "ops@demo.constellation-hub.local",
+        "password": "operator123",
+        "full_name": "Demo Operator",
+        "role": "operator",
+    },
+    {
+        "username": "demo_admin",
+        "email": "admin@demo.constellation-hub.local",
+        "password": "admin123",
+        "full_name": "Demo Administrator",
+        "role": "admin",
+    },
+]
+
+async def seed_demo_data(session: AsyncSession):
+    """Seed the database with demo data."""
+    logger.info("Initializing demo data seed...")
+    
+    # Create constellation
+    logger.info("📡 Creating demo constellation...")
+    result = await session.execute(text("""
+        INSERT INTO constellations (name, description, orbit_regime, altitude_km, inclination_deg, num_planes, sats_per_plane)
+        VALUES (:name, :description, :orbit_regime, :altitude_km, :inclination_deg, :num_planes, :sats_per_plane)
+        RETURNING id
+    """), {
+        "name": "Demo LEO Constellation",
+        "description": "Demonstration constellation for Constellation Hub showcase",
+        "orbit_regime": "LEO",
+        "altitude_km": 550.0,
+        "inclination_deg": 53.0,
+        "num_planes": 1,
+        "sats_per_plane": len(DEMO_TLES)
+    })
+    constellation_id = result.scalar_one()
+    
+    # Create satellites
+    for tle_data in DEMO_TLES:
+        await session.execute(text("""
+            INSERT INTO satellites (constellation_id, name, norad_id, tle_line1, tle_line2, mass_kg, power_watts, orbit_type, status)
+            VALUES (:constellation_id, :name, :norad_id, :tle1, :tle2, :mass_kg, :power_watts, :orbit_type, :status)
+        """), {
+            "constellation_id": constellation_id,
+            "name": tle_data["name"],
+            "norad_id": tle_data["norad_id"],
+            "tle1": tle_data["tle1"],
+            "tle2": tle_data["tle2"],
+            "mass_kg": 260.0 if "STARLINK" in tle_data["name"] else 420000.0,
+            "power_watts": 1500.0 if "STARLINK" in tle_data["name"] else 84000.0,
+            "orbit_type": "LEO",
+            "status": "operational"
+        })
+    
+    # Create ground stations
+    logger.info("🌍 Creating ground stations...")
+    for gs_data in GROUND_STATIONS:
+        await session.execute(text("""
+            INSERT INTO ground_stations (name, latitude, longitude, elevation_m, min_elevation_deg, status)
+            VALUES (:name, :latitude, :longitude, :elevation_m, :min_elevation_deg, :status)
+        """), {
+            **gs_data,
+            "status": "operational"
+        })
+    
+    # Create demo users
+    logger.info("👥 Creating demo users...")
+    for user_data in DEMO_USERS:
+        # Check if user exists
+        result = await session.execute(
+            text("SELECT id FROM users WHERE username = :username"),
+            {"username": user_data["username"]}
+        )
+        if result.scalar_one_or_none():
+            logger.info(f"   ⚠️  User '{user_data['username']}' already exists, skipping")
+            continue
+        
+        await session.execute(text("""
+            INSERT INTO users (username, email, hashed_password, full_name, role, is_active)
+            VALUES (:username, :email, :hashed_password, :full_name, :role, :is_active)
+        """), {
+            "username": user_data["username"],
+            "email": user_data["email"],
+            "hashed_password": hash_password(user_data["password"]),
+            "full_name": user_data["full_name"],
+            "role": user_data["role"],
+            "is_active": True
+        })
+    
+    logger.info("✅ Demo data seed completed")
+    return {"status": "success", "message": "Demo data loaded successfully"}