Evidência e escopo

Interface confirmada na etapa 9B: abertura da biblioteca local, formulário vazio e revisão do pacote inicial, cancelada sem gravar. A listagem foi fotografada durante o carregamento; permissões com VA real continuam pendentes. Identificado no código: painel, controles, fluxo de lote, regras do cliente e renderização de símbolos. Pendente: verificar rótulos e disponibilidade implantada, permissões reais, associação, salvamento, erros e apresentação visual em fixture.

Bibliotecas, acesso e coleções

O código do painel exige Field Admin disponível, sessão autenticada, capacidade de ícones e perfil VA ou ZA. VA recebe a biblioteca do local; ZA pode alternar entre Zapt · todos os locais e Somente este local. A autorização efetiva é verificada no servidor e depende do local. Um VA não administra a coleção global pelo painel.

O pacote inicial incluído no aplicativo contém 79 desenhos em Zapt Essenciais · 01 e Zapt Hospitalar · 01; outros pacotes são descritos em registros técnicos de desenvolvimento, incluindo aeroportos, eventos e parques. Não há garantia de que todos estejam publicados no ambiente atual. O nome da coleção agrupa recursos e não cria automaticamente categorias para o cliente.

O seletor disponível previsto pela API retorna somente revisões publicadas, ativas e de finalidade POI, globais ou do local autorizado. Rascunhos não são escolhas publicadas. Publicar SVG gera uma URL de revisão pública, inclusive para recursos locais; não coloque dados confidenciais no desenho.

Lista, filtros e estados

Buscar nome, setor ou palavra-chave pesquisa nome, coleção, setores e palavras, sem distinguir acentos ou maiúsculas. Filtrar coleção oferece coleções dos itens carregados; Filtrar situação oferece Ativos, Arquivados e Todos. Atualizar recarrega; Carregar mais ícones aparece quando há outra página. O código solicita até 100 itens por página e filtra apenas o que já foi carregado.

Os cartões mostram prévia, nome, coleção e estado: Rascunho, Publicado · vN, Novo rascunho · vN em uso ou Arquivado. A seleção de rascunhos e Publicar selecionados se aplicam a itens ativos com rascunho.

Criação e edição

• Escolher SVG: seleciona o desenho e permite substituí-lo no rascunho. Prévia em 24, 40 e 64 px não é limite de resolução do arquivo.
• Nome: obrigatório, até 140 caracteres; ajuda a encontrar o desenho, independente do nome da categoria. O código também define o nome português no rascunho.
• Coleção: obrigatória, até 100 caracteres; identifica o agrupamento.
• Setores e Palavras de busca: termos separados por vírgula ou ponto e vírgula; orientam pesquisa e identificação.
• Finalidade: Categorias de pontos de interesse, Interface do produto ou Gamificação. O seletor de categoria descrito na API usa finalidade POI.
• Cores: Uma cor · adapta-se à categoria, ou Preservar cores do arquivo. O efeito depende do renderizador.
• Origem e Licença ou autorização de uso: obrigatórias no formulário, até 300 caracteres; registre a procedência e autorização.

Salvar rascunho cria ou atualiza o rascunho. Voltar à biblioteca sai da edição. O histórico oferece Versões publicadas; Arquivar ícone e Restaurar ícone mudam seu estado. Arquivado não é oferecido para novas escolhas, mas revisões existentes permanecem disponíveis. Não foi identificada exclusão definitiva nesse painel.

Arquivos e importação

O editor aceita SVG de até 64 KiB. Importar arquivos aceita até 100 arquivos por vez, com até 4 MiB no total: SVG individual de até 64 KiB ou JSON no formato zapt-icon-pack-v1. A validação do pacote aceita de 1 a 500 ícones, com os campos obrigatórios previstos no formato; o limite total da seleção também se aplica. O servidor valida e normaliza SVG e aceita geometria básica, rejeitando scripts, CSS, fontes, links, imagens, referências externas e animações.

Revisar importação mostra prévias e permite Coleção para todos (opcional) e Licença para todos (opcional). Cada item precisa de licença própria ou comum para habilitar Salvar rascunhos. Cancelar importação abandona a revisão antes de salvar. Os rascunhos são criados um a um; ao falhar, os já criados permanecem e a lista pendente é reduzida. A chave de importação estável ajuda a retomar uma resposta ambígua, mas não elimina a necessidade de conferência.

Publicação, concorrência e atualização

Publicar um rascunho cria uma revisão imutável; a aplicação registra o par de identificador e revisão. O código informa que mapas existentes mantêm suas versões. Publicar uma revisão posterior não atualiza automaticamente referências fixadas. Para usar uma nova versão, a associação correspondente precisa ser atualizada pelo fluxo autorizado e conferida.

Edição, publicação e arquivamento enviam a geração esperada do registro; conflito pode ser recusado se houve alteração concorrente. A publicação em lote é sequencial e pode ser parcial. Carregando…, mensagens de progresso, erro e Atualizar biblioteca estão previstos no código; as respostas reais não foram ensaiadas. Publicar ícone e publicar mapa são operações distintas.

POIs e vista superior/2D

Categorias podem armazenar referência a uma revisão específica; o renderizador consulta essa revisão e considera as regras de aparência e herança da categoria. Um POI também pode ter tipo semântico; a implementação consulta símbolo correspondente e admite configuração por metadados, com símbolo de reserva quando necessário. O caminho de configuração visível e o comportamento em cada produto ainda precisam de validação.

Na planta Indoor, o código registra símbolos de escadas e rampas paramétricas e de GLBs específicos de escada/escada rolante. Elevadores podem ser ícone ou barra no trecho de acesso. A planta também prevê entradas externas e saídas de emergência em contextos específicos. Esses casos não significam substituição automática de todos os objetos 3D por itens desta biblioteca; piso, geometria e estado da vista influenciam o resultado. Conferir por ensaio isolado.

Veja jornada de ícones, POIs e categorias e jornada de texturas.