Esta guía explica el acceso y la navegación por niveles (mapa → organización → áreas → procesos → sistemas), el uso del identificador alias, y cómo registrar casos de uso de IA conectados a procesos.
1. Acceso y autenticación
- Accede a https://twin.toscai.com
- Introduce Usuario y Contraseña (no se solicita tenant). Tras iniciar sesión, se guarda un token Bearer en tu navegador.
2. Conceptos clave
- Organización: unidad de negocio dentro del tenant (legalName, BU, tags).
- Área: agrupación funcional (p. ej., Ventas, Operaciones), con KPIs y prioridad.
- Proceso: flujo operativo con objetivo, alcance, entradas/salidas, SLAs.
- Sistema: aplicaciones/servicios (ERP/CRM/ETL/DB/APP) y su criticidad.
- Alias: identificador corto y único (apto para URL) para organizaciones, áreas, procesos y sistemas. Sustituye a “slug”.
3. Navegación por niveles
- Selector de organización (orgs.html) tras el login.
- Mapa de entidades conectadas (graph.html) como vista inicial por defecto: nodos de procesos y sistemas, filtros, propuestas de vínculos y drill‑down por doble clic.
- Menú lateral fijo: Organización, Áreas, Procesos, Sistemas, Ontología, Casos de uso IA.
4. Crear Organización
- En “Organizaciones”, rellena Nombre y Alias (único dentro del tenant).
- Pulsa “Crear”. La tabla se actualizará automáticamente.
5. Crear Área
- Abre una organización.
- En “Áreas”, indica Nombre y Alias. Opcionalmente podrás añadir KPIs/owner más adelante.
6. Crear Proceso
- Abre una organización.
- En “Procesos”, indica Nombre y Alias. Posteriormente podrás completar objetivo, alcance, SLAs, etc.
7. Sistemas e Integraciones
Desde el menú de API podrás crear Sistemas y relacionarlos con Procesos (rol SOURCE/TARGET/SUPPORT) y tipo de interfaz (API/EVENT/FILE/RPA/MANUAL).
8. Casos de uso de IA
En “Casos de uso IA” puedes vincular iniciativas concretas de IA a cada Proceso (título y descripción). API disponible para alta, listado y borrado.
9. API (referencia rápida)
| Método | Ruta | Auth | Descripción |
|---|
| POST | /api/v1/auth/login | — | Login (username, password). Tenant es opcional (autodeduce por usuario). |
| GET | /api/v1/auth/me | Bearer | Perfil del usuario autenticado |
| GET | /api/v1/orgs | Bearer | Organizaciones del tenant |
| POST | /api/v1/orgs | Bearer | Crear organización |
| GET | /api/v1/areas?orgId=... | Bearer | Áreas de la organización |
| POST | /api/v1/areas | Bearer | Crear área |
| GET | /api/v1/processes?orgId=... | Bearer | Procesos de la organización |
| POST | /api/v1/processes | Bearer | Crear proceso |
| GET | /api/v1/systems?orgId=... | Bearer | Sistemas de la organización |
| POST | /api/v1/systems | Bearer | Crear sistema |
| GET | /api/v1/graph?orgId=... | Bearer | Grafo (nodos procesos/sistemas y vínculos) |
| POST | /api/v1/links | Bearer | Crear vínculo Proceso–Sistema (aceptar propuesta desde el mapa) |
| GET | /api/v1/ai-cases?orgId=... | Bearer | Listar casos de uso IA por organización |
| GET | /api/v1/ai-cases?processId=... | Bearer | Listar casos de uso IA por proceso |
| POST | /api/v1/ai-cases | Bearer | Crear caso de uso IA (organizationId, processId, title, description) |
| DELETE | /api/v1/ai-cases/:id | Bearer | Eliminar caso de uso IA |
10. Roles y seguridad
- ADMIN: administración completa del tenant/org.
- MEMBER: operaciones cotidianas (lectura/edición limitada).
11. Solución de problemas
- 401 Unauthorized: renueva sesión desde Login.
- Alias en uso: utiliza uno distinto por organización.
- Network: revisa que accedes vía
https://twin.toscai.com.
Próximas versiones: RBAC completo, edición de ontología, export del grafo (PNG) y guardado de layout por organización.
Descargar PDF (esta misma guía en PDF)