Documentos do quadro e da tarefa

anexe arquivos ao board ou a uma task, classifique os por tipo, consulte os metadados e baixe ou exclua documentos conforme sua permissão pré requisito tenha um projeto com a capability de documentos, board principal e uma sessão com permissão de visualização upload e exclusão exigem a permissão de edição; a gestão do catálogo exige edição e ser administrador do workspace ou responsável pelo projeto documentos existem em dois níveis a tela "documentos" do board lista os arquivos do projeto/board em uma tabela completa; o painel compacto no detalhe da task mostra apenas os anexos daquela tarefa o mesmo fluxo oferece visualizar detalhes, baixar o arquivo, excluir e, no nível do projeto, configurar os tipos ativos cada arquivo é enviado como multipart e recebe um tipo do catálogo do projeto o tipo pode exigir campos de metadados; por isso o upload não é apenas escolher um arquivo selecione a classificação, preencha os campos obrigatórios e só então envie o catálogo é específico do projeto e os tipos inativos deixam de ser opções para novos uploads passo a passo abrir documentos do board no menu do projeto, selecione "documentos" a rota valida que a capability está ativa, que o board solicitado é o board principal do projeto e que sua sessão tem permissão de visualização em um acesso válido, o painel completo mostra o título documentos e a tabela; não é necessário navegar por uma tela intermediária conferir o catálogo de tipos se você pode enviar ou administrar tipos, o painel carrega o catálogo ativo do projeto e preenche o seletor de tipo o tipo determina o nome exibido na coluna tipo e quais campos de metadados serão pedidos selecione outro tipo quando o arquivo representar uma categoria diferente, em vez de colocar tudo em uma classificação genérica escolher o arquivo na área de envio, escolha um arquivo pelo seletor o componente mantém o arquivo selecionado até o envio terminar, permite escolher novamente o mesmo arquivo e não inicia a operação sem um arquivo confirme que o tipo ativo desejado continua selecionado antes de prosseguir preencher metadados quando o tipo possui campos configurados, preencha cada campo obrigatório mostrado abaixo do seletor o painel verifica o texto depois de remover espaços em branco; um campo vazio ou composto apenas por espaços impede o envio campos opcionais podem permanecer vazios e não são enviados como metadado enviar o documento clique em "enviar" o agility envia o arquivo, o tipo e os metadados para o escopo atual durante a operação, os controles de upload ficam ocupados; em sucesso, o campo de arquivo e os metadados são limpos e a lista é recarregada no mesmo projeto em caso de falha, o arquivo e o tipo permanecem disponíveis para tentar novamente ler a tabela a tabela apresenta nome do documento, tipo, tamanho, autor e ações o tamanho é formatado para leitura humana; o autor usa o nome projetado pelo backend e não exibe uuid use a busca por nome e o filtro de tipo para reduzir a lista sem alterar os arquivos abrir detalhes e baixar na coluna de ações, abra o botão de informações para ver os detalhes do documento use o botão de download para obter um blob autenticado com o nome original do arquivo; a credencial é enviada pelo fetch e não exposta na url o download exige permissão de visualização excluir um documento do board se sua sessão tem edição, use o botão de exclusão na linha o painel abre a confirmação para o documento específico; confirme apenas depois de verificar nome e tipo em sucesso, o diálogo fecha e a tabela é recarregada a exclusão não é exibida para sessões sem a permissão correspondente configurar tipos do projeto no cabeçalho da variante completa, administradores e o responsável do projeto com permissão de edição veem "configurar tipos" abra esse diálogo para consultar ou manter o catálogo do projeto cada tipo tem nome, descrição, estado ativo e campos ordenados, que podem ser marcados como obrigatórios desative um tipo que não deve mais ser usado sem alterar os documentos históricos que já o utilizam anexar no detalhe da task abra um cartão no quadro e role até "anexos" o painel compacto usa o escopo board + projeto + task, lista apenas os arquivos vinculados àquela tarefa e repete o envio, detalhes, download e exclusão conforme as permissões um documento enviado nesse local não aparece como anexo de outra task; o vínculo é específico da tarefa trocar de projeto ou tarefa com segurança ao mudar de projeto, board ou task, o painel cancela carregamentos e operações do escopo anterior, limpa seleção, metadados, filtros e diálogos e carrega a nova lista aguarde a lista do novo contexto antes de enviar ou excluir, para evitar trabalhar no arquivo de outro escopo verificação o documento enviado aparece na tabela com nome, tipo, tamanho e autor, e pode ser encontrado pela busca ou filtro de tipo abrir detalhes mostra o documento correto; baixar cria um arquivo com o nome original depois de uma exclusão confirmada, a linha desaparece após o recarregamento e o documento não pode mais ser aberto naquele escopo no detalhe de uma task, o anexo aparece somente no painel compacto daquela task um tipo com campo obrigatório só permite o envio depois que o metadado correspondente é preenchido erros comuns documentos indisponíveis para a sessão sem capability efetiva de documentos, sem board principal correspondente ou sem permissão de visualização, o acesso é bloqueado e o painel informa a indisponibilidade entre no projeto correto ou peça a permissão ao administrador; não tente contornar a rota direta nenhum tipo ativo para upload o seletor de tipo fica desabilitado quando o catálogo não tem tipos ativos um administrador ou responsável deve criar/ativar um tipo na configuração do projeto antes do primeiro envio metadado obrigatório ausente o botão de upload não avança enquanto algum campo obrigatório estiver vazio ou só contiver espaços selecione o tipo correto e preencha todos os campos exigidos; metadados opcionais não precisam ser inventados upload ou download interrompido uma falha de rede ou troca de contexto cancela a operação no upload, a seleção permanece para retry; no download, repita a ação no documento ainda listado e confirme que você continua no mesmo projeto/board exclusão sem permissão de edição a ação de excluir não aparece para uma sessão somente leitura solicite acesso de edição ao administrador; visualizar e baixar continuam separados da capacidade de apagar