docs: corregir errores en todos .md para el backend arrojados por Markdown linter in vs-code

- se adiciono la documentacion faltante para el Gateway
- se arreglaron los problemas de identacion de todos los .md de cada uno de los microservicios

Author: Oyhs-co

backend/docs/Auth-Service.md

@@ -1,6 +1,7 @@
 # Auth-Service
 
 ## Descripción General
+
 El `auth-service` es un microservicio responsable de gestionar la autenticación de usuarios, incluyendo inicio de sesión, validación de tokens y cierre de sesión. Utiliza FastAPI para la capa de API e integra una base de datos PostgreSQL para los datos de los usuarios.
 
 ---
@@ -22,49 +23,61 @@ El `auth-service` es un microservicio responsable de gestionar la autenticación
 ## Descripción de Archivos
 
 ### 1. `models/schemas.py`
+
 - Contiene modelos de Pydantic para la validación de solicitudes y respuestas.
 - Ejemplo:
+
   ```python
   class LoginRequest(BaseModel):
       username: str
       password: str
   ```
 
 ### 2. `utils/db.py`
+
 - Maneja las conexiones y consultas a la base de datos.
 - Ejemplo:
+
   ```python
   def get_connection():
       """Establece una conexión con la base de datos PostgreSQL."""
   ```
 
 ### 3. `utils/jwt_manager.py`
+
 - Administra los JSON Web Tokens (JWT) para la autenticación.
 - Ejemplo:
+
   ```python
   def generate_token(data: dict) -> str:
       """Genera un JWT con la carga útil proporcionada."""
   ```
 
 ### 4. `utils/dependencies.py`
+
 - Proporciona dependencias reutilizables para las rutas de FastAPI, como la validación de tokens.
 - Ejemplo:
+
   ```python
   def get_current_user(token: str = Depends(oauth2_scheme)):
       """Extrae el usuario actual del token JWT."""
   ```
 
 ### 5. `auth_service.py`
+
 - Implementa la lógica principal de autenticación, incluyendo inicio de sesión y validación de tokens.
 - Ejemplo:
+
   ```python
   def login(self, username: str, password: str) -> str | None:
       """Autentica a un usuario y genera un token JWT."""
   ```
 
 ### 6. `main.py`
+
 - Define la aplicación FastAPI y las rutas para el servicio de autenticación.
 - Ejemplo:
+
   ```python
   @router.post("/login", response_model=TokenResponse)
   def login_route(request: LoginRequest):
@@ -94,4 +107,4 @@ El `auth-service` es un microservicio responsable de gestionar la autenticación
 
 - **Seguridad**: Asegúrate de que el `JWT_SECRET` se almacene de forma segura (por ejemplo, en variables de entorno).
 - **Escalabilidad**: El servicio está diseñado para ser sin estado, lo que lo hace escalable.
-- **Extensibilidad**: Es fácil agregar nuevos métodos de autenticación o backends de bases de datos.
+- **Extensibilidad**: Es fácil agregar nuevos métodos de autenticación o backends de bases de datos.

backend/docs/DocumentService.md

@@ -1,23 +1,26 @@
-```markdown
 # Document Service
 
 El microservicio **Document Service** es responsable de gestionar documentos, permitiendo su creación, listado y eliminación. Este servicio está construido con **FastAPI** y utiliza **SQLAlchemy** para la gestión de la base de datos.
 
 ## Endpoints
 
 ### 1. Subir Documento
+
 **POST** `/api/documents/`
 
 Sube un nuevo documento al sistema.
 
-#### Parámetros:
+#### Parámetros
+
 - `nombre` (form-data, requerido): Nombre del documento.
 - `proyecto_id` (form-data, requerido): ID del proyecto asociado.
 - `archivo` (form-data, requerido): Archivo a subir.
 
-#### Respuesta:
+#### Respuesta
+
 - **200 OK**: Devuelve el documento creado.
 - **Ejemplo de respuesta:**
+
   ```json
   {
     "id": 1,
@@ -30,13 +33,16 @@ Sube un nuevo documento al sistema.
 ---
 
 ### 2. Listar Documentos
+
 **GET** `/api/documents/`
 
 Obtiene una lista de todos los documentos almacenados.
 
-#### Respuesta:
+#### Respuesta - Listar Documentos
+
 - **200 OK**: Devuelve una lista de documentos.
 - **Ejemplo de respuesta:**
+
   ```json
   [
     {
@@ -51,17 +57,21 @@ Obtiene una lista de todos los documentos almacenados.
 ---
 
 ### 3. Eliminar Documento
+
 **DELETE** `/api/documents/{doc_id}`
 
 Elimina un documento por su ID.
 
-#### Parámetros:
+#### Parámetros - Eliminar Documento
+
 - `doc_id` (path, requerido): ID del documento a eliminar.
 
-#### Respuesta:
+#### Respuesta - Eliminar Documento
+
 - **200 OK**: Documento eliminado exitosamente.
 - **404 Not Found**: Si el documento no existe.
 - **Ejemplo de respuesta:**
+
   ```json
   {
     "msg": "Documento eliminado"
@@ -72,7 +82,6 @@ Elimina un documento por su ID.
 
 ## Estructura del Proyecto
 
-```
 backend/
 └── api/
     └── Documents-service/
@@ -84,9 +93,9 @@ backend/
             │   └── document_schema.py
             └── routes/
                 └── document_routes.py
-```
 
-### Archivos principales:
+### Archivos principales
+
 - **`database.py`**: Configuración de la base de datos SQLite y creación de la sesión.
 - **`document_service.py`**: Punto de entrada del microservicio.
 - **`document_routes.py`**: Define los endpoints del servicio.
@@ -129,10 +138,13 @@ def notify(action: str, doc_id: int):
 
 1. Clona el repositorio.
 2. Instala las dependencias:
+
    ```bash
    pip install -r requirements.txt
    ```
+
 3. Ejecuta el servicio:
+
    ```bash
    uvicorn document_service:app --reload
    ```
@@ -145,4 +157,4 @@ def notify(action: str, doc_id: int):
 - **SQLAlchemy**: ORM para la gestión de la base de datos.
 - **Pydantic**: Validación de datos.
 
----
+---

backend/docs/ExternalToolService.md

@@ -1,11 +1,9 @@
-```markdown
 # ExternalToolService
 
 El servicio `ExternalToolService` es una aplicación basada en FastAPI que proporciona una interfaz para interactuar con herramientas externas como servicios de inteligencia artificial, procesamiento de pagos y almacenamiento en la nube.
 
 ## Estructura del Proyecto
 
-```
 ExternalToolService/
 ├── app/
 │   ├── app/
@@ -16,49 +14,48 @@ ExternalToolService/
 │   │   │   ├── payment.py
 │   │   │   ├── storage.py
 │   │   ├── main.py
-```
 
 ### Archivos Principales
 
 #### `main.py`
 
 Este archivo define las rutas principales de la API y gestiona la autenticación básica.
 
-- **Rutas**:
+- __Rutas__:
   - `POST /analyze`: Analiza datos utilizando un servicio de inteligencia artificial.
   - `POST /pay`: Procesa pagos utilizando un adaptador de pago.
   - `GET /storage-url`: Genera una URL de almacenamiento para un archivo.
 
-- **Autenticación**:
+- __Autenticación__:
   Utiliza autenticación básica con un usuario y contraseña predeterminados (`admin` y `123`).
 
 #### `adapters/manager.py`
 
 Define la clase base `ExternalTool` y el gestor `ExternalToolManager` para interactuar con herramientas externas.
 
-- **Clases**:
+- __Clases__:
   - `ExternalTool`: Clase abstracta que define el método `execute`.
   - `ExternalToolManager`: Clase que utiliza herramientas externas para ejecutar operaciones.
 
 #### `adapters/ai.py`
 
 Implementa el adaptador `AIServiceAdapter` para servicios de inteligencia artificial.
 
-- **Método**:
+- __Método__:
   - `execute(data)`: Devuelve un resumen y un análisis de sentimiento del contenido proporcionado.
 
 #### `adapters/payment.py`
 
 Implementa el adaptador `PaymentAdapter` para procesamiento de pagos.
 
-- **Método**:
+- __Método__:
   - `execute(data)`: Simula el procesamiento de un pago y devuelve el estado.
 
 #### `adapters/storage.py`
 
 Implementa el adaptador `CloudStorageAdapter` para generar URLs de almacenamiento.
 
-- **Método**:
+- __Método__:
   - `execute(data)`: Genera una URL simulada para un archivo.
 
 ## Ejemplo de Uso
@@ -90,23 +87,26 @@ curl -X GET "http://localhost:8000/storage-url?filename=example.txt" \
 
 ## Requisitos
 
-- **Python**: 3.8 o superior
-- **Dependencias**: FastAPI, Uvicorn
+- __Python__: 3.8 o superior
+- __Dependencias__: FastAPI, Uvicorn
 
 ## Instalación
 
 1. Clona el repositorio:
+
    ```bash
    git clone <url-del-repositorio>
    cd ExternalToolService/app
    ```
 
 2. Instala las dependencias:
+
    ```bash
    pip install -r requirements.txt
    ```
 
 3. Ejecuta el servidor:
+
    ```bash
    uvicorn main:app --reload
    ```
@@ -115,4 +115,3 @@ curl -X GET "http://localhost:8000/storage-url?filename=example.txt" \
 
 - Este servicio utiliza autenticación básica para proteger las rutas.
 - Los adaptadores implementan lógica simulada y pueden extenderse para integrarse con servicios reales.
-```