Documentos

Caminho no backoffice: backoffice/documents

Disponível para funções: Administrador do Sistema, Administrador; Equipe de Operações pode visualizar, criar e editar

Visão Geral

A página de Documentos gerencia uma biblioteca de documentos hierárquica onde a equipe publica conteúdo para pilotos. Documentos podem conter manuais, procedimentos operacionais padrão, políticas da empresa, guias de frota e qualquer outro material de referência. A biblioteca suporta aninhamento de pastas, conteúdo em texto rico, restrições de visibilidade e documentos gerados automaticamente a partir de perfis do sistema.

Campos do Documento

Campo	Descrição
Título	O nome de exibição do documento ou pasta.
Slug	Identificador seguro para URL gerado automaticamente a partir do título.
Conteúdo	Corpo em texto rico do documento. Suporta texto formatado (negrito, itálico, listas, títulos), links, imagens e outros conteúdos ricos. Exibido com estilo tipográfico completo para legibilidade.
Pai	O documento ou pasta pai na hierarquia (definido via parent_id). Deixe vazio para itens de nível superior.
Ordem	Valor numérico controlando a posição de exibição dentro da pasta pai.
Visibilidade	Controla quem pode ver o documento (veja seção Visibilidade abaixo).
Patente	Para visibilidade PATENTE, a patente específica necessária para visualizar o documento (via rank_id).
Licença	Para visibilidade LICENÇA, a licença específica necessária para visualizar o documento (via license_id).

Hierarquia de Pastas

Documentos são organizados em uma estrutura de árvore. Qualquer documento pode servir como pasta tendo documentos filhos aninhados abaixo dele. O backoffice exibe a árvore completa como uma lista aninhada e ordenável mostrando a profundidade da hierarquia visualmente.

A equipe pode:

• Criar pastas -- adicionar um documento que serve como contêiner para documentos filhos.
• Criar documentos -- adicionar páginas de conteúdo dentro de pastas ou no nível superior.
• Reordenar itens -- usar os controles cima/baixo para alterar a ordem dos documentos dentro do mesmo pai.
• Aninhar documentos -- mover documentos para dentro ou fora de pastas alterando seu pai.

Configurações de Visibilidade

Cada documento tem uma configuração de visibilidade que controla quais pilotos podem acessá-lo:

Visibilidade	Descrição
PÚBLICO	Visível para todos os pilotos independentemente de patente ou status de licença.
EQUIPE	Visível apenas para membros da equipe (administradores, equipe de operações). Não mostrado a pilotos comuns.
PATENTE	Visível apenas para pilotos que possuem a patente especificada (ou superior). Requer selecionar um rank_id.
LICENÇA	Visível apenas para pilotos que possuem a licença ativa especificada. Requer selecionar um license_id.

Restrições de visibilidade são herdadas contextualmente -- se uma pasta é restrita, seu conteúdo é efetivamente restrito também, mesmo que documentos filhos individuais tenham configurações de visibilidade mais amplas.

Documentos Gerados Automaticamente

Alguns documentos são gerados automaticamente a partir de perfis do sistema:

• Documentos LoadProfile -- gerados a partir de configurações de perfil de carga, contendo dados de payload e peso.
• Documentos FdmProfile -- gerados a partir de configurações de perfil de Monitoramento de Dados de Voo, contendo regras de gatilhos e critérios de pontuação.

Documentos gerados automaticamente possuem conteúdo somente leitura que reflete o estado atual de seu perfil fonte. A equipe não pode editar manualmente o conteúdo desses documentos, mas pode:

• Regenerar o conteúdo para refletir quaisquer alterações feitas no perfil fonte.
• Editar campos de metadados (título, visibilidade, ordem, pai).

Isso garante que a documentação permaneça sincronizada com a configuração real do sistema.

Ações da Equipe

Ação	Descrição
Criar	Adicionar um novo documento ou pasta, definindo seu conteúdo, pai e visibilidade.
Editar	Modificar metadados, conteúdo ou configurações de visibilidade de um documento existente.
Excluir	Remover um documento ou pasta da biblioteca.
Reordenar	Alterar a ordem usando controles cima/baixo dentro do mesmo nível pai.
Regenerar	Para documentos gerados automaticamente, atualizar o conteúdo a partir do perfil fonte.