Infrastructure Documentation

Quick navigation for infrastructure documentation.

Contents

Document	Description
README	Overview and architecture
Docker Compose	Service orchestration and configuration
Monitoring	Prometheus and Grafana setup
Logging	Loki and Promtail log aggregation
Alerting	Alertmanager configuration
CI/CD	GitHub Actions pipelines

Quick Reference

Common Commands

# Start all services
docker compose up -d

# View logs
docker compose logs -f chatbot backend rag_service

# Restart service
docker compose restart chatbot

# Check status
docker compose ps

URLs

Service	URL	Purpose
Frontend	http://localhost:5173	Web application
Backend API	http://localhost:8000	Gateway API
Grafana	http://localhost:3001	Dashboards
Prometheus	http://localhost:9093	Metrics
Alertmanager	http://localhost:9094	Alerts
Loki	http://localhost:3100	Logs
Phoenix	http://localhost:6006	LLM traces

Key Files

File	Purpose
docker-compose.yml	Service definitions
prometheus.yml	Metrics scraping config
promtail-config.yml	Log collection config
alertmanager/	Alert rules and routing
grafana/provisioning/	Dashboards and datasources
.github/workflows/	CI/CD pipelines

Architecture Diagram

graph TB
    subgraph "Application Layer"
        FE[Frontend :5173]
        BE[Backend :8000]
        CB[Chatbot :8080]
        RAG[RAG Service :8081]
    end
    
    subgraph "AI/ML Layer"
        LLM[vLLM/Gemini]
        Ollama[Ollama]
    end
    
    subgraph "Data Layer"
        Mongo[(MongoDB)]
        Qdrant[(Qdrant)]
    end
    
    subgraph "Observability"
        Prom[Prometheus]
        Graf[Grafana]
        Loki[Loki]
        AM[Alertmanager]
    end
    
    FE --> BE
    BE --> CB
    CB --> RAG
    CB --> LLM
    RAG --> Ollama
    RAG --> Qdrant
    BE --> Mongo
    CB --> Mongo
    
    BE -.-> Prom
    CB -.-> Prom
    RAG -.-> Prom
    Prom --> Graf
    Loki --> Graf
    Prom --> AM

---

← Back to Services