Integraciones
GitHub, Notion y Draw.io conectados a tu flujo de trabajo
Dos sistemas distintos, no confundir
GitHub se conecta por cuenta personal (pestaña Integraciones del perfil). Notion es un sistema aparte, configurado a nivel de aplicación y gestionado por proyecto, no aparece en esa misma pestaña.GitHub
La conexión con GitHub usa OAuth estándar: vas a tu perfil, pestaña Integraciones, y autorizas a P32 a acceder con permisos read:user y repo. Es por cuenta de usuario: cada persona conecta la suya, y esa conexión es la que se usa para listar y conectar repositorios en cualquier proyecto donde participe.
- El token de acceso se guarda cifrado con AES-256-GCM, nunca en texto plano.
- Se excluye explícitamente de cualquier respuesta de la API; solo se descifra en el servidor cuando hace falta.
- Si el token pierde el permiso "repo" (repos privados no visibles) o caduca, se te pide reconectar la cuenta.
Único proveedor disponible hoy
El sistema está pensado para admitir más proveedores en el futuro, pero actualmente solo GitHub está implementado en esta pestaña.Notion
Notion no es una integración por usuario: es una única cuenta de Notion configurada a nivel de toda la aplicación (por variables de entorno), que sirve a todos los workspaces y proyectos por igual. Se activa y gestiona por proyecto, desde su propio apartado, no desde el perfil.
Sincronización de un solo sentido
Los datos fluyen P32 → Notion, nunca al revés. No hay ningún mecanismo que lea contenido de Notion de vuelta hacia P32.Enlazar un proyecto crea una página en Notion (con enlace público compartible) y, opcionalmente, un Ticket Digital: una página hija estructurada así:
| Sección | Contenido |
|---|---|
| Introducción | Objetivo del proyecto y trabajo realizado (texto editable), más una imagen de portada opcional. |
| Desarrollo | Página hija con un registro cronológico auto-generado: una línea por tarea (con prioridad, equipo y estado) y un bloque por cada revisión de cliente con su resultado. |
| Secciones predefinidas (activables) | Jerarquía (árbol ASCII del repositorio conectado), info del proyecto, miembros, equipos. |
| Secciones personalizadas | Añadidas a mano desde P32: título, icono y bloques básicos (encabezados, párrafo, callout, divisor, lista, to-do, cita, toggle colapsable). |
Un botón "Sincronizar" vuelve a empujar todo el contenido a Notion: reescribe la introducción, regenera cada sección predefinida activa y reconstruye por completo la página de Desarrollo con el estado más reciente de tareas y revisiones. Es una acción manual, no una sincronización automática. Desvincular un proyecto archiva sus páginas de Notion (recuperables desde la papelera) y borra el enlace.
Draw.io
Draw.io (diagrams.net) se integra a nivel de proyecto, dentro del apartado Docs que desbloquea la categoría de equipo Dev. No es una cuenta conectada ni requiere OAuth: subes un archivo .drawio o .xml (hasta 1MB sin comprimir) y P32 valida que sea un export real de draw.io antes de guardarlo.
- El XML se comprime con gzip antes de guardarse en base de datos, y se descomprime al leerlo.
- La vista previa se renderiza embebida vía el visor público de diagrams.net, en modo solo lectura.
- Un botón "Editar" abre el diagrama directamente en el editor real de draw.io (app.diagrams.net); el contenido viaja en la URL del navegador, nunca pasa por el servidor de P32 en ese paso.
No es una cuenta conectada
A diferencia de GitHub o Notion, no hay autenticación ni token propio: cualquiera con acceso al proyecto puede subir o ver diagramas de draw.io, sujeto a los mismos permisos que el resto de Docs.