🚀 Add feature: Frontend app working stub

🚀 Add feature: Ruff linting
🚀 Add feature: Logging

backend/app/config.py

@@ -0,0 +1,15 @@
+import logging
+
+from app.models import AvailableSource, AvailableSourcesResponse
+
+logger = logging.getLogger("base_logger")
+
+available_sources = AvailableSourcesResponse(
+    sources=[
+        AvailableSource(
+            display_name="LinkedIn Shares",
+            name="linkedin_shares",
+            format="csv",
+        ),
+    ],
+)

backend/app/models.py

@@ -1,4 +1,4 @@
-from typing import Dict
+from typing import Dict, List
 
 from pydantic import BaseModel
 
@@ -7,6 +7,7 @@ class AnalysisRequest(BaseModel):
     analysis_type: str
     filters: Dict
 
+
 class AnalysisResponse(BaseModel):
     result: str
 
@@ -41,8 +42,19 @@ class GenerateResponse(BaseModel):
 
 
 class ImportRequest(BaseModel):
+    type: str
     data: str
 
 
 class ImportResponse(BaseModel):
     status: str
+
+
+class AvailableSource(BaseModel):
+    display_name: str
+    name: str
+    format: str
+
+
+class AvailableSourcesResponse(BaseModel):
+    sources: List[AvailableSource]

backend/app/routers/analysis_router.py

@@ -1,14 +1,20 @@
+from app.config import logger
+from app.models import AnalysisRequest, AnalysisResponse
 from fastapi import APIRouter
 
-from app.models import AnalysisResponse, AnalysisRequest
-
 analysis_router = APIRouter(prefix="/analysis", tags=["Analysis"])
 
+
 @analysis_router.post("/", response_model=AnalysisResponse)
 def analysis_data(request: AnalysisRequest):
     """
-    Analysis imported data (e.g., sentiment, keywords, or patterns).
+    Analyse imported data (e.g., sentiment, keywords, or patterns).
     """
+    logger.info(
+        f"Analyse imported data "
+        f"on {request.analysis_type} "
+        f"with filters {request.filters}"
+    )
     # Placeholder for analysis logic
     analysis = ...
     return {"analysis": analysis}

backend/app/routers/convert_router.py

@@ -1,18 +1,20 @@
+from app.config import logger
+from app.models import ConversionRequest, ConversionResponse
 from fastapi import APIRouter
 
-from app.models import ConversionResponse, ConversionRequest
-
 convert_router = APIRouter(prefix="/convert", tags=["Convert"])
 
+
 @convert_router.post("/", response_model=ConversionResponse)
 def convert_data(request: ConversionRequest):
     """
-    Convert data from one format to another (e.g., JSON to CSV, text to XML).
+    Convert data from a source to normalized JSON
     """
+    logger.info(f"Converting {request.source_type} data to normalized JSON")
     # Example conversion logic (replace with actual implementation)
     converted_data = ...
 
     return {
         "converted_data": converted_data,
-        "status": "success"
+        "status": "success",
     }

backend/app/routers/export_router.py

@@ -1,13 +1,15 @@
+from app.config import logger
+from app.models import ExportRequest, ExportResponse
 from fastapi import APIRouter
 
-from app.models import ExportRequest, ExportResponse
-
 export_router = APIRouter(prefix="/export", tags=["Export"])
 
+
 @export_router.post("/", response_model=ExportResponse)
 def export_data(request: ExportRequest):
     """
     Export analysed data (e.g., as JSON, CSV, or PDF).
     """
+    logger.info(f"Exporting data as {request.format}")
     exported_data_url = ...
     return {"url": exported_data_url}

backend/app/routers/generate_router.py

@@ -1,7 +1,7 @@
+from app.config import logger
+from app.models import GenerateRequest, GenerateResponse
 from fastapi import APIRouter
 
-from app.models import GenerateResponse, GenerateRequest
-
 generate_router = APIRouter(prefix="/generate", tags=["Generate"])
 
 
@@ -11,5 +11,5 @@ def generate_content(request: GenerateRequest):
     Generate new content (e.g., text, images, or summaries).
     """
     # Placeholder for generation logic (e.g., LLM, AI model)
-    response = ...
-    return response
+    logger.info(f"Generating content for request: {request.prompt}")
+    return ...

backend/app/routers/import_router.py

@@ -1,7 +1,7 @@
+from app.config import available_sources, logger
+from app.models import AvailableSourcesResponse, ImportRequest, ImportResponse
 from fastapi import APIRouter
 
-from app.models import ImportRequest, ImportResponse
-
 import_router = APIRouter(prefix="/import", tags=["Import"])
 
 
@@ -10,5 +10,17 @@ def import_data(request: ImportRequest):
     """
     Import data (e.g., text, files, or structured data).
     """
-    response = ...
-    return response
+    logger.info(f"Receiver importation request: {request.type}")
+    return ...
+
+
+@import_router.get(
+    "/available_sources", response_model=AvailableSourcesResponse
+)
+def get_available_sources():
+    """
+    Get available sources from database
+    :return: Available sources in an AvailableSourcesResponse object
+    """
+    logger.info("Get available sources from database")
+    return available_sources

backend/main.py

@@ -1,10 +1,9 @@
-from fastapi import FastAPI
-from app.routers.convert_router import convert_router
-from app.routers.import_router import import_router
 from app.routers.analysis_router import analysis_router
+from app.routers.convert_router import convert_router
 from app.routers.export_router import export_router
 from app.routers.generate_router import generate_router
-
+from app.routers.import_router import import_router
+from fastapi import FastAPI
 
 app = FastAPI(title="Retro API", description="Retro content management system")