Upload 10 files

main.py

@@ -1,8 +1,11 @@
 import os
 import sys
 import logging
-from fastapi import FastAPI, HTTPException, Depends
+from fastapi import FastAPI, HTTPException, Depends, Request
 from fastapi.middleware.cors import CORSMiddleware
+from fastapi.openapi.docs import get_swagger_ui_html, get_redoc_html
+from fastapi.openapi.utils import get_openapi
+from fastapi.staticfiles import StaticFiles
 import uvicorn
 from dotenv import load_dotenv
 
@@ -39,11 +42,55 @@ except ImportError:
 # Load environment variables
 load_dotenv()
 
-# Create FastAPI app
+# Create FastAPI app with detailed metadata
 app = FastAPI(
     title="Seamo Auth Server",
-    description="Authentication and non-AI services for the Seamo platform",
-    version="1.0.0"
+    description="""
+    # Seamo Authentication API
+
+    The Seamo Auth Server provides authentication and user management services for the Seamo platform.
+
+    ## Features
+
+    * User registration and authentication
+    * Project management
+    * Journal management
+    * Access control
+
+    ## Authentication
+
+    Most endpoints require authentication. Use the /api/auth/token endpoint to obtain access tokens.
+    """,
+    version="1.0.0",
+    contact={
+        "name": "Seamo Team",
+        "url": "https://seamo.earth/contact",
+        "email": "[email protected]",
+    },
+    license_info={
+        "name": "MIT",
+        "url": "https://opensource.org/licenses/MIT",
+    },
+    openapi_tags=[
+        {
+            "name": "Authentication",
+            "description": "Operations related to user authentication and token management",
+        },
+        {
+            "name": "Projects",
+            "description": "Operations related to project management",
+        },
+        {
+            "name": "Journals",
+            "description": "Operations related to journal management",
+        },
+        {
+            "name": "General",
+            "description": "General server information and health checks",
+        },
+    ],
+    docs_url=None,  # Disable default docs
+    redoc_url=None  # Disable default redoc
 )
 
 # Configure CORS
@@ -390,15 +437,67 @@ async def shutdown_db_client():
     except Exception as e:
         logger.error(f"Error closing database connection: {str(e)}")
 
-# Root endpoint
-@app.get("/")
+# Custom API documentation routes
+@app.get("/docs", include_in_schema=False)
+async def custom_swagger_ui_html():
+    return get_swagger_ui_html(
+        openapi_url=app.openapi_url,
+        title=f"{app.title} - Swagger UI",
+        oauth2_redirect_url=app.swagger_ui_oauth2_redirect_url,
+        swagger_js_url="https://cdn.jsdelivr.net/npm/[email protected]/swagger-ui-bundle.js",
+        swagger_css_url="https://cdn.jsdelivr.net/npm/[email protected]/swagger-ui.css",
+        swagger_favicon_url="https://fastapi.tiangolo.com/img/favicon.png",
+    )
+
+@app.get("/redoc", include_in_schema=False)
+async def redoc_html():
+    return get_redoc_html(
+        openapi_url=app.openapi_url,
+        title=f"{app.title} - ReDoc",
+        redoc_js_url="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js",
+        redoc_favicon_url="https://fastapi.tiangolo.com/img/favicon.png",
+    )
+
+# Root endpoint with API information
+@app.get("/", tags=["General"])
 async def root():
-    return {"message": "Welcome to Seamo Auth Server"}
+    """
+    Root endpoint providing information about the Seamo Auth Server API.
+
+    Returns:
+        dict: Basic information about the API and links to documentation.
+    """
+    return {
+        "message": "Welcome to Seamo Auth Server API",
+        "version": "1.0.0",
+        "documentation": {
+            "swagger_ui": "/docs",
+            "redoc": "/redoc",
+            "openapi_json": "/openapi.json"
+        },
+        "endpoints": {
+            "health": "/health",
+            "auth": "/api/auth",
+            "projects": "/api/projects",
+            "journals": "/api/journals"
+        }
+    }
 
 # Health check endpoint
-@app.get("/health")
+@app.get("/health", tags=["General"])
 async def health_check():
-    return {"status": "healthy"}
+    """
+    Health check endpoint to verify the server is running properly.
+
+    Returns:
+        dict: Status information about the server.
+    """
+    return {
+        "status": "healthy",
+        "version": "1.0.0",
+        "database_connected": hasattr(app, "db_conn"),
+        "database_type": getattr(app, "db_type", "unknown")
+    }
 
 # Import and include routers
 from app.api.routes import auth_router, projects_router, journals_router