# asantiagonunezg/c24_5_2024-2_g17_autoportec architecture

> Architecture diagram of the GitHub repository asantiagonunezg/c24_5_2024-2_g17_autoportec, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/asantiagonunezg/c24_5_2024-2_g17_autoportec
- Repository: https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec

## Overview

AutoPorTec automatiza la recopilación de materiales de cursos de TECSUP Canvas y su organización en Google Drive como un portafolio digital. El flujo principal va desde que el docente proporciona un token de Canvas y elige un curso hasta la descarga, clasificación y carga de archivos en una estructura de carpetas. También incluye inicio de sesión con Google, selección de una carpeta raíz, perfil y páginas de ayuda. Las rutas y servicios centrales están muestreados; algunas pantallas y capacidades se conocen solo por el árbol, por lo que no se les atribuyen flujos internos no verificados.

Main entry points: [`BACKEND/app/__init__.py`](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/__init__.py) (Aplicación Flask), [`BACKEND/app/routes/canvaslms.py`](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/canvaslms.py) (Rutas Canvas), [`BACKEND/app/routes/auth.py`](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/auth.py) (Autenticación Google), [`BACKEND/app/services/estructura_portafolio_service.py`](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/services/estructura_portafolio_service.py) (Estructura del portafolio)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Acceso y navegación"]
  node_app["Aplicación Flask<br/>[__init__.py]"]
  node_auth["Autenticación Google<br/>[auth.py]"]
  node_home["Inicio y errores<br/>[routes.py]"]
  node_help["Ayuda<br/>[ayuda.py]"]
  node_profile["Perfil<br/>[perfil.py]"]
end

subgraph group_canvas["Canvas y recopilación"]
  node_upload_page["Página de carga<br/>[pd_routes.py]"]
  node_canvas_routes["Rutas Canvas<br/>[canvaslms.py]"]
  node_canvas_service["Servicio Canvas<br/>[canvas_service.py]"]
end

subgraph group_drive["Organización y Drive"]
  node_classifier["Clasificación de archivos<br/>[carpetas.py]"]
  node_structure["Estructura del portafolio"]
  node_drive_service["Servicio Google Drive"]
  node_folder_page["Selector de carpeta"]
end

node_teacher(("Docente"))
node_google{{"Google OAuth"}}
node_canvas_api{{"Canvas LMS"}}
node_drive[("Google Drive")]

node_teacher -->|"usa"| node_app
node_app -->|"registra rutas"| node_auth
node_app -->|"registra rutas"| node_home
node_app -->|"registra rutas"| node_help
node_app -->|"registra rutas"| node_profile
node_app -->|"registra rutas"| node_upload_page
node_app -->|"registra rutas"| node_canvas_routes
node_app -->|"registra rutas"| node_folder_page
node_teacher -->|"inicia sesión"| node_auth
node_auth -->|"autoriza usuario"| node_google
node_auth -->|"redirige a"| node_profile
node_teacher -->|"proporciona token"| node_canvas_routes
node_canvas_routes -->|"consulta cursos y archivos"| node_canvas_service
node_canvas_service -->|"solicita cursos y materiales"| node_canvas_api
node_canvas_routes -->|"clasifica archivos"| node_classifier
node_canvas_routes -->|"crea carpetas"| node_structure
node_classifier -->|"usa categorías"| node_structure
node_structure -->|"busca o crea carpetas"| node_drive_service
node_canvas_routes -->|"comprueba y sube archivos"| node_drive_service
node_drive_service -->|"lee y escribe"| node_drive
node_teacher -->|"elige carpeta raíz"| node_folder_page

click node_app "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/__init__.py"
click node_auth "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/auth.py"
click node_home "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/routes.py"
click node_help "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/ayuda.py"
click node_profile "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/perfil.py"
click node_upload_page "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/pd_routes.py"
click node_canvas_routes "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/canvaslms.py"
click node_canvas_service "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/services/canvas_service.py"
click node_classifier "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/services/carpetas.py"
click node_structure "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/services/estructura_portafolio_service.py"
click node_drive_service "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/services/google_drive_service.py"
click node_folder_page "https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/portafolio_digital.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth,node_home,node_help,node_profile toneBlue
class node_upload_page,node_canvas_routes,node_canvas_service,node_drive toneAmber
class node_classifier,node_structure,node_drive_service,node_folder_page toneMint
class node_teacher,node_google,node_canvas_api toneIndigo
```

## Components

### Acceso y navegación

- [Aplicación Flask](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/__init__.py): `BACKEND/app/__init__.py`
- [Autenticación Google](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/auth.py): `BACKEND/app/routes/auth.py`
- [Inicio y errores](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/routes.py): `BACKEND/app/routes/routes.py`
- [Ayuda](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/ayuda.py): `BACKEND/app/routes/ayuda.py`
- [Perfil](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/perfil.py): `BACKEND/app/routes/perfil.py`

### Canvas y recopilación

- [Página de carga](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/pd_routes.py): `BACKEND/app/routes/pd_routes.py`
- [Rutas Canvas](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/canvaslms.py): `BACKEND/app/routes/canvaslms.py`
- [Servicio Canvas](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/services/canvas_service.py): `BACKEND/app/services/canvas_service.py`

### Organización y Drive

- [Clasificación de archivos](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/services/carpetas.py): `BACKEND/app/services/carpetas.py`
- [Estructura del portafolio](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/services/estructura_portafolio_service.py): `BACKEND/app/services/estructura_portafolio_service.py`
- [Servicio Google Drive](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/services/google_drive_service.py): `BACKEND/app/services/google_drive_service.py`
- [Selector de carpeta](https://github.com/asantiagonunezg/c24_5_2024-2_g17_autoportec/blob/main/BACKEND/app/routes/portafolio_digital.py): `BACKEND/app/routes/portafolio_digital.py`

### Other components

- **Docente**
- **Google OAuth**
- **Canvas LMS**
- **Google Drive**

## Connections

- Docente → Aplicación Flask: usa
- Aplicación Flask → Autenticación Google: registra rutas (evidence: `BACKEND/app/__init__.py`)
- Aplicación Flask → Inicio y errores: registra rutas (evidence: `BACKEND/app/__init__.py`)
- Aplicación Flask → Ayuda: registra rutas (evidence: `BACKEND/app/__init__.py`)
- Aplicación Flask → Perfil: registra rutas (evidence: `BACKEND/app/__init__.py`)
- Aplicación Flask → Página de carga: registra rutas (evidence: `BACKEND/app/__init__.py`)
- Aplicación Flask → Rutas Canvas: registra rutas (evidence: `BACKEND/app/__init__.py`)
- Aplicación Flask → Selector de carpeta: registra rutas (evidence: `BACKEND/app/__init__.py`)
- Docente → Autenticación Google: inicia sesión
- Autenticación Google → Google OAuth: autoriza usuario (evidence: `BACKEND/app/routes/auth.py`)
- Autenticación Google → Perfil: redirige a (evidence: `BACKEND/app/routes/auth.py`)
- Docente → Rutas Canvas: proporciona token
- Rutas Canvas → Servicio Canvas: consulta cursos y archivos (evidence: `BACKEND/app/routes/canvaslms.py`)
- Servicio Canvas → Canvas LMS: solicita cursos y materiales (evidence: `BACKEND/app/services/canvas_service.py`)
- Rutas Canvas → Clasificación de archivos: clasifica archivos (evidence: `BACKEND/app/routes/canvaslms.py`)
- Rutas Canvas → Estructura del portafolio: crea carpetas (evidence: `BACKEND/app/routes/canvaslms.py`)
- Clasificación de archivos → Estructura del portafolio: usa categorías (evidence: `BACKEND/app/services/carpetas.py`)
- Estructura del portafolio → Servicio Google Drive: busca o crea carpetas (evidence: `BACKEND/app/services/estructura_portafolio_service.py`)
- Rutas Canvas → Servicio Google Drive: comprueba y sube archivos (evidence: `BACKEND/app/routes/canvaslms.py`)
- Servicio Google Drive → Google Drive: lee y escribe (evidence: `BACKEND/app/services/google_drive_service.py`)
- Docente → Selector de carpeta: elige carpeta raíz
