Documentos
Ruta del backoffice: backoffice/documents
Disponible para roles: Administrador del Sistema, Administrador; el Personal de Operaciones puede ver, crear y editar
Descripción General
La página de Documentos gestiona una biblioteca jerárquica de documentos donde el personal publica contenido para los pilotos. Los documentos pueden contener manuales, procedimientos operativos estándar, políticas de la empresa, guías de flota y cualquier otro material de referencia. La biblioteca admite anidamiento de carpetas, contenido de texto enriquecido, restricciones de visibilidad y documentos auto-generados desde perfiles del sistema.
Campos del Documento
| Campo | Descripción |
|---|---|
| Título | El nombre de visualización del documento o carpeta. |
| Slug | Identificador seguro para URL generado automáticamente basado en el título. |
| Contenido | Cuerpo de texto enriquecido del documento. Admite texto formateado (negrita, cursiva, listas, encabezados), enlaces, imágenes y otro contenido enriquecido. Se muestra con estilo tipográfico completo para mayor legibilidad. |
| Principal | El documento o carpeta principal en la jerarquía (establecido vía parent_id). Dejar vacío para elementos de nivel superior. |
| Orden | Valor numérico que controla la posición de visualización dentro de su carpeta principal. |
| Visibilidad | Controla quién puede ver el documento (ver sección de Visibilidad a continuación). |
| Rango | Para visibilidad RANGO, el rango específico requerido para ver el documento (vía rank_id). |
| Licencia | Para visibilidad LICENCIA, la licencia específica requerida para ver el documento (vía license_id). |
Jerarquía de Carpetas
Los documentos están organizados en una estructura de árbol. Cualquier documento puede servir como carpeta teniendo documentos hijos anidados debajo. El backoffice muestra el árbol completo como una lista anidada y ordenable que muestra visualmente la profundidad de la jerarquía.
El personal puede:
- Crear carpetas -- agregar un documento que sirva como contenedor para documentos hijos.
- Crear documentos -- agregar páginas de contenido dentro de carpetas o en el nivel superior.
- Reordenar elementos -- usar los controles arriba/abajo para cambiar el orden de los documentos dentro del mismo nivel principal.
- Anidar documentos -- mover documentos dentro o fuera de carpetas cambiando su principal.
Configuración de Visibilidad
Cada documento tiene una configuración de visibilidad que controla qué pilotos pueden acceder a él:
| Visibilidad | Descripción |
|---|---|
| PÚBLICA | Visible para todos los pilotos independientemente de su rango o estado de licencia. |
| PERSONAL | Visible solo para miembros del personal (administradores, personal de operaciones). No se muestra a pilotos regulares. |
| RANGO | Visible solo para pilotos que posean el rango especificado (o superior). Requiere seleccionar un rank_id. |
| LICENCIA | Visible solo para pilotos que posean la licencia activa especificada. Requiere seleccionar un license_id. |
Las restricciones de visibilidad se heredan contextualmente -- si una carpeta está restringida, su contenido está efectivamente restringido también, incluso si los documentos hijos individuales tienen configuraciones de visibilidad más amplias.
Documentos Auto-Generados
Algunos documentos se generan automáticamente desde perfiles del sistema:
- Documentos de LoadProfile -- generados desde configuraciones de perfiles de carga, conteniendo datos de carga útil y peso.
- Documentos de FdmProfile -- generados desde configuraciones de perfiles de Monitoreo de Datos de Vuelo, conteniendo reglas de disparadores y criterios de puntuación.
Los documentos auto-generados tienen contenido de solo lectura que refleja el estado actual de su perfil de origen. El personal no puede editar manualmente el contenido de estos documentos, pero puede:
- Regenerar el contenido para reflejar cualquier cambio realizado en el perfil de origen.
- Editar campos de metadatos (título, visibilidad, orden, principal).
Esto asegura que la documentación se mantenga sincronizada con la configuración real del sistema.
Acciones del Personal
| Acción | Descripción |
|---|---|
| Crear | Agregar un nuevo documento o carpeta, estableciendo su contenido, principal y visibilidad. |
| Editar | Modificar los metadatos, contenido o configuración de visibilidad de un documento existente. |
| Eliminar | Eliminar un documento o carpeta de la biblioteca. |
| Reordenar | Cambiar el orden usando controles arriba/abajo dentro del mismo nivel principal. |
| Regenerar | Para documentos auto-generados, actualizar el contenido desde el perfil de origen. |