Add initial project structure with Dockerfile, environment configuration, and FastAPI setup

.env.example

@@ -0,0 +1,6 @@
+APP_NAME=Tracker Microservice
+APP_VERSION=1.0.0
+DEBUG=false
+LOG_LEVEL=INFO
+PORT=8003
+ROOT_PATH=

Dockerfile

@@ -0,0 +1,24 @@
+FROM python:3.11-slim-bullseye AS base
+
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PATH="/home/user/.local/bin:$PATH"
+
+RUN apt-get update && apt-get install -y \
+    openssl \
+    ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN useradd -m -u 1000 user
+USER user
+WORKDIR /app
+
+COPY --chown=user ./requirements.txt requirements.txt
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir --upgrade -r requirements.txt
+
+COPY --chown=user . /app
+
+EXPOSE 7860
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860", "--workers", "2", "--log-level", "info"]

app/__init__.py

@@ -0,0 +1 @@
+"""Cuatrolabs Tracker microservice package."""

app/core/__init__.py

@@ -0,0 +1 @@
+"""Core utilities for Tracker microservice."""

app/core/config.py

@@ -0,0 +1,36 @@
+"""
+Configuration settings for Tracker microservice.
+Loads environment variables and provides application settings.
+"""
+from typing import List
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    """Application settings loaded from environment variables"""
+
+    # Application
+    APP_NAME: str = "Tracker Microservice"
+    APP_VERSION: str = "1.0.0"
+    DEBUG: bool = False
+
+    # Logging
+    LOG_LEVEL: str = "INFO"
+
+    # CORS
+    CORS_ORIGINS: List[str] = [
+        "http://localhost:3000",
+        "http://localhost:8000",
+    ]
+
+    # Pydantic v2 config
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        case_sensitive=True,
+        extra="allow",
+    )
+
+
+# Global settings instance
+settings = Settings()

app/main.py

@@ -0,0 +1,64 @@
+"""
+Main FastAPI application for Tracker Microservice.
+"""
+import logging
+import os
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from app.core.config import settings
+from app.tracker.controllers.router import router as tracker_router
+
+logging.basicConfig(level=getattr(logging, settings.LOG_LEVEL.upper(), logging.INFO))
+logger = logging.getLogger(__name__)
+
+app = FastAPI(
+    title=settings.APP_NAME,
+    description="Employee Tracker - Basic service scaffold",
+    version=settings.APP_VERSION,
+    docs_url="/docs",
+    redoc_url="/redoc",
+    root_path=os.getenv("ROOT_PATH", ""),
+)
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=settings.CORS_ORIGINS,
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+@app.on_event("startup")
+async def startup_event():
+    logger.info("Starting Tracker Microservice")
+
+
+@app.on_event("shutdown")
+async def shutdown_event():
+    logger.info("Shutting down Tracker Microservice")
+
+
+@app.get("/health", tags=["health"])
+async def health_check():
+    return {
+        "status": "healthy",
+        "service": "tracker-microservice",
+        "version": settings.APP_VERSION,
+    }
+
+
+app.include_router(tracker_router, prefix="/api/v1")
+
+
+if __name__ == "__main__":
+    import uvicorn
+
+    uvicorn.run(
+        "app.main:app",
+        host="0.0.0.0",
+        port=int(os.getenv("PORT", "8003")),
+        reload=True,
+        log_level=settings.LOG_LEVEL.lower(),
+    )

app/tracker/__init__.py

@@ -0,0 +1 @@
+"""Tracker domain package."""

app/tracker/controllers/__init__.py

@@ -0,0 +1 @@
+"""Tracker controllers."""

app/tracker/controllers/router.py

@@ -0,0 +1,10 @@
+"""Tracker router."""
+from fastapi import APIRouter
+
+router = APIRouter(prefix="/tracker", tags=["tracker"])
+
+
+@router.get("/ping")
+async def ping():
+    """Simple ping endpoint."""
+    return {"status": "ok"}

requirements.txt

@@ -0,0 +1,5 @@
+fastapi==0.104.1
+uvicorn[standard]==0.24.0
+pydantic>=2.12.5,<3.0.0
+pydantic-settings>=2.0.0
+python-dotenv==1.0.0