Initial commit: Constellation Hub MVP

- 4 backend microservices (core-orbits, routing, ground-scheduler, ai-agents)
- React + TypeScript frontend with space-themed UI
- Docker Compose orchestration
- GitHub Actions CI/CD workflows
- Comprehensive documentation for operators and executives
- Apache 2.0 license

Author: amychenn

.env.example

@@ -0,0 +1,32 @@
+# Environment Configuration
+# Copy this file to .env and fill in your values
+
+# Database Configuration
+DATABASE_URL=postgresql://constellation:constellation@localhost:5432/constellation_hub
+POSTGRES_USER=constellation
+POSTGRES_PASSWORD=constellation
+POSTGRES_DB=constellation_hub
+
+# Redis Configuration (optional)
+REDIS_URL=redis://localhost:6379
+
+# Service URLs (for inter-service communication)
+CORE_ORBITS_URL=http://core-orbits:8001
+ROUTING_URL=http://routing:8002
+GROUND_SCHEDULER_URL=http://ground-scheduler:8003
+AI_AGENTS_URL=http://ai-agents:8004
+
+# Frontend Configuration
+VITE_API_BASE_URL=http://localhost:8001
+
+# AI/LLM Configuration
+# Options: mock, openai, anthropic, local
+LLM_PROVIDER=mock
+LLM_API_KEY=
+LLM_MODEL=gpt-4
+
+# Logging
+LOG_LEVEL=INFO
+
+# Development
+DEBUG=true

.github/workflows/ci-backend.yml

@@ -0,0 +1,184 @@
+name: CI - Backend
+
+on:
+  push:
+    branches: [main, develop]
+    paths:
+      - 'backend/**'
+      - '.github/workflows/ci-backend.yml'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'backend/**'
+
+jobs:
+  test-core-orbits:
+    name: Test Core Orbits Service
+    runs-on: ubuntu-latest
+    
+    services:
+      postgres:
+        image: postgres:15-alpine
+        env:
+          POSTGRES_USER: test
+          POSTGRES_PASSWORD: test
+          POSTGRES_DB: test_db
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+          cache-dependency-path: backend/core-orbits/requirements.txt
+      
+      - name: Install dependencies
+        run: |
+          cd backend/core-orbits
+          pip install -r requirements.txt
+      
+      - name: Run linting
+        run: |
+          cd backend/core-orbits
+          pip install ruff
+          ruff check .
+      
+      - name: Run tests
+        env:
+          DATABASE_URL: postgresql://test:test@localhost:5432/test_db
+        run: |
+          cd backend/core-orbits
+          pytest -v --tb=short
+
+  test-routing:
+    name: Test Routing Service
+    runs-on: ubuntu-latest
+    
+    services:
+      postgres:
+        image: postgres:15-alpine
+        env:
+          POSTGRES_USER: test
+          POSTGRES_PASSWORD: test
+          POSTGRES_DB: test_db
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+          cache-dependency-path: backend/routing/requirements.txt
+      
+      - name: Install dependencies
+        run: |
+          cd backend/routing
+          pip install -r requirements.txt
+      
+      - name: Run linting
+        run: |
+          cd backend/routing
+          pip install ruff
+          ruff check .
+      
+      - name: Run tests
+        env:
+          DATABASE_URL: postgresql://test:test@localhost:5432/test_db
+        run: |
+          cd backend/routing
+          pytest -v --tb=short
+
+  test-ground-scheduler:
+    name: Test Ground Scheduler Service
+    runs-on: ubuntu-latest
+    
+    services:
+      postgres:
+        image: postgres:15-alpine
+        env:
+          POSTGRES_USER: test
+          POSTGRES_PASSWORD: test
+          POSTGRES_DB: test_db
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+          cache-dependency-path: backend/ground-scheduler/requirements.txt
+      
+      - name: Install dependencies
+        run: |
+          cd backend/ground-scheduler
+          pip install -r requirements.txt
+      
+      - name: Run linting
+        run: |
+          cd backend/ground-scheduler
+          pip install ruff
+          ruff check .
+      
+      - name: Run tests
+        env:
+          DATABASE_URL: postgresql://test:test@localhost:5432/test_db
+        run: |
+          cd backend/ground-scheduler
+          pytest -v --tb=short
+
+  test-ai-agents:
+    name: Test AI Agents Service
+    runs-on: ubuntu-latest
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+          cache-dependency-path: backend/ai-agents/requirements.txt
+      
+      - name: Install dependencies
+        run: |
+          cd backend/ai-agents
+          pip install -r requirements.txt
+      
+      - name: Run linting
+        run: |
+          cd backend/ai-agents
+          pip install ruff
+          ruff check .
+      
+      - name: Run tests
+        run: |
+          cd backend/ai-agents
+          pytest -v --tb=short

.github/workflows/ci-frontend.yml

@@ -0,0 +1,59 @@
+name: CI - Frontend
+
+on:
+  push:
+    branches: [main, develop]
+    paths:
+      - 'frontend/**'
+      - '.github/workflows/ci-frontend.yml'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'frontend/**'
+
+jobs:
+  build-and-test:
+    name: Build and Test Frontend
+    runs-on: ubuntu-latest
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: frontend/web/package-lock.json
+      
+      - name: Install dependencies
+        run: |
+          cd frontend/web
+          npm ci
+      
+      - name: Run linting
+        run: |
+          cd frontend/web
+          npm run lint
+      
+      - name: Run type check
+        run: |
+          cd frontend/web
+          npm run type-check
+      
+      - name: Run tests
+        run: |
+          cd frontend/web
+          npm test -- --run
+      
+      - name: Build
+        run: |
+          cd frontend/web
+          npm run build
+      
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: frontend-build
+          path: frontend/web/dist
+          retention-days: 7

.github/workflows/deploy-dev.yml

@@ -0,0 +1,53 @@
+name: Deploy to Dev
+
+on:
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Deployment environment'
+        required: true
+        default: 'dev'
+        type: choice
+        options:
+          - dev
+          - staging
+
+jobs:
+  deploy:
+    name: Deploy to ${{ github.event.inputs.environment }}
+    runs-on: ubuntu-latest
+    environment: ${{ github.event.inputs.environment }}
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up kubectl
+        uses: azure/setup-kubectl@v3
+        with:
+          version: 'latest'
+      
+      # NOTE: This is a template. Configure your Kubernetes cluster connection.
+      # - name: Configure Kubernetes
+      #   run: |
+      #     echo "${{ secrets.KUBE_CONFIG }}" | base64 -d > kubeconfig
+      #     export KUBECONFIG=kubeconfig
+      
+      - name: Deploy with Docker Compose (Dev)
+        if: github.event.inputs.environment == 'dev'
+        run: |
+          echo "To deploy to dev environment:"
+          echo "1. SSH to your dev server"
+          echo "2. cd to constellation-hub/infra/docker"
+          echo "3. Run: docker-compose up -d"
+          echo ""
+          echo "This workflow is a template for future automation."
+      
+      - name: Deploy with Kubernetes (Staging)
+        if: github.event.inputs.environment == 'staging'
+        run: |
+          echo "To deploy to staging environment:"
+          echo "1. Configure KUBE_CONFIG secret"
+          echo "2. Apply manifests from infra/k8s/"
+          echo "3. kubectl apply -f infra/k8s/"
+          echo ""
+          echo "This workflow is a template for future automation."