labfusion/
├── docker-compose.yml          # Production Docker setup
├── docker-compose.dev.yml      # Development Docker setup
├── env.example                 # Environment configuration template
├── .gitignore                  # Git ignore rules
├── README.md                   # Comprehensive documentation
├── .gitea/                     # Gitea Actions CI/CD
│   └── workflows/              # Pipeline definitions
│       ├── ci.yml              # Main CI pipeline
│       ├── api-gateway.yml     # Java Spring Boot pipeline
│       ├── service-adapters.yml # Python FastAPI pipeline
│       ├── api-docs.yml        # Node.js Express pipeline
│       ├── frontend.yml        # React frontend pipeline
│       └── integration-tests.yml # Integration testing
├── services/                   # Modular microservices
│   ├── api-gateway/           # Java Spring Boot API Gateway (Port 8080)
│   │   ├── src/main/java/com/labfusion/
│   │   │   ├── model/         # JPA entities (User, Dashboard, Widget, Event, DeviceState)
│   │   │   ├── repository/    # Data repositories
│   │   │   ├── service/       # Business logic
│   │   │   └── controller/    # REST controllers
│   │   ├── src/main/resources/
│   │   │   └── application.yml # Spring configuration
│   │   ├── pom.xml            # Maven dependencies
│   │   ├── Dockerfile         # Production container
│   │   ├── Dockerfile.dev     # Development container
│   │   └── README.md          # Service documentation
│   ├── service-adapters/      # Python FastAPI Service Adapters (Port 8000)
│   │   ├── main.py            # FastAPI application (modular)
│   │   ├── models/            # Pydantic schemas
│   │   │   ├── __init__.py
│   │   │   └── schemas.py     # Request/response models
│   │   ├── routes/            # API endpoints
│   │   │   ├── __init__.py
│   │   │   ├── general.py     # Root, health, services
│   │   │   ├── home_assistant.py # HA integration
│   │   │   ├── frigate.py     # Frigate integration
│   │   │   ├── immich.py      # Immich integration
│   │   │   └── events.py      # Event management
│   │   ├── services/          # Business logic
│   │   │   ├── __init__.py
│   │   │   ├── config.py      # Service configurations
│   │   │   └── redis_client.py # Redis connection
│   │   ├── requirements.txt   # Python dependencies
│   │   ├── Dockerfile         # Production container
│   │   ├── Dockerfile.dev     # Development container
│   │   └── README.md          # Service documentation
│   ├── metrics-collector/     # Go Metrics Collector (Port 8081) 🚧
│   │   ├── main.go            # Go application (planned)
│   │   ├── go.mod             # Go dependencies (planned)
│   │   ├── Dockerfile         # Production container (planned)
│   │   ├── Dockerfile.dev     # Development container (planned)
│   │   └── README.md          # Service documentation
│   ├── notification-service/  # Node.js Notification Service (Port 8082) 🚧
│       ├── src/               # TypeScript source (planned)
│       ├── package.json       # Node.js dependencies (planned)
│       ├── Dockerfile         # Production container (planned)
│       ├── Dockerfile.dev     # Development container (planned)
│       └── README.md          # Service documentation
│   └── api-docs/              # API Documentation Service (Port 8083) ✅
│       ├── server.js          # Express server for unified docs
│       ├── package.json       # Node.js dependencies
│       ├── Dockerfile         # Production container
│       ├── Dockerfile.dev     # Development container
│       └── README.md          # Service documentation
├── frontend/                  # React Frontend (Port 3000)
│   ├── src/
│   │   ├── components/        # React components
│   │   │   ├── common/        # Reusable UI components
│   │   │   │   ├── ErrorBoundary.js    # Error boundary component
│   │   │   │   ├── LoadingSpinner.js   # Loading state component
│   │   │   │   └── StatusIcon.js       # Status icon component
│   │   │   ├── dashboard/     # Dashboard-specific components
│   │   │   │   ├── SystemStatsCards.js # System statistics cards
│   │   │   │   ├── ServiceStatusList.js # Service status list
│   │   │   │   └── RecentEventsList.js # Recent events list
│   │   │   ├── Dashboard.js   # Main dashboard (refactored)
│   │   │   ├── SystemMetrics.js # Metrics visualization
│   │   │   ├── Settings.js    # Configuration UI
│   │   │   ├── ServiceStatusBanner.js # Service status banner
│   │   │   └── OfflineMode.js # Offline mode component
│   │   ├── hooks/             # Custom React hooks
│   │   │   └── useServiceStatus.js # Service status and data hooks
│   │   ├── services/          # API and external services
│   │   │   └── api.js         # Centralized API client
│   │   ├── utils/             # Utility functions
│   │   │   └── errorHandling.js # Error handling utilities
│   │   ├── constants/         # Configuration constants
│   │   │   └── index.js       # UI constants, colors, messages
│   │   ├── App.js             # Main app component (with ErrorBoundary)
│   │   ├── index.js           # App entry point
│   │   └── index.css          # Global styles
│   ├── public/
│   │   └── index.html         # HTML template
│   ├── package.json           # Node.js dependencies (with prop-types)
│   ├── Dockerfile             # Production container
│   ├── Dockerfile.dev         # Development container
│   ├── CLEAN_CODE.md          # Clean code documentation
│   └── RESILIENCE.md          # Frontend resilience features
└── docs/                      # Documentation
    ├── specs.md              # Project specifications
    ├── structure.txt         # Project structure
    ├── progress.md           # Development progress tracking
    └── CI_CD.md             # CI/CD pipeline documentation