Integraciones
GitHub y Notion 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). |
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.