Acervo

Rascunho — ainda não verificado em hml

Escrito a partir do código, sem percorrer as telas em hml. Nomes de campo e ordem de passos podem divergir do que a interface mostra. Ao validar, corrija o que estiver diferente e remova este aviso.

Objetivo

Registrar as armas de um cliente e manter a documentação de cada uma acessível e válida.

Antes de começar

O módulo fica em /<slug>/acervo. O acervo de um cliente específico também aparece na aba Acervo do dossiê dele, em /<slug>/clientes/<id>.

Toda arma pertence a um cliente — não existe arma solta no acervo do clube.

Passos

1. Cadastrar uma arma

Selecione o cliente e informe tipo, calibre, marca e modelo.

Esses quatro campos são listas de valores do clube, e não texto livre. Quando o valor que você precisa não está na lista, cadastre-o na hora, pela própria tela (Cadastrar novo valor).

Antes de criar um valor novo, procure na lista. “Taurus”, “TAURUS” e “Taurus S.A.” cadastrados como três marcas diferentes é o que estraga o relatório por marca depois — e a limpeza é manual.

A confirmação é Arma cadastrada!.

2. Anexar os documentos da arma

Use Adicionar Documento à Arma e escolha o tipo do documento. É aqui que mora o CRAF de cada arma.

Documento de arma acompanha a arma, não o cliente: quem procura pelo CRAF na aba Documentos do dossiê não encontra.

3. Registrar acessórios

Acessórios (colete, mira, e afins) são registrados à parte e podem ser vinculados a uma arma.

4. Acompanhar o conjunto

O módulo traz uma visão do acervo do clube: distribuição por status e armas por tipo. Serve para achar o que está com pendência sem abrir cliente por cliente.

5. Conferir do lado do cliente

O cliente vê o próprio acervo em /<slug>/portal/acervo, no navegador e no aplicativo.

Como saber que deu certo

• A arma aparece no acervo do cliente com tipo, calibre, marca e modelo preenchidos.
• Os documentos dela estão anexados e abrem.
• O cliente enxerga a arma em /<slug>/portal/acervo.

Se der errado

A marca ou o modelo não estão na lista. Cadastre pela própria tela. Confira antes se não existe com grafia diferente.

Cadastrei a arma no cliente errado. Corrija a vinculação antes de anexar documento — documento anexado à arma errada precisa ser refeito.

O cliente não vê a arma no portal. Confirme que ela foi cadastrada no cliente certo. Na lista do acervo do clube é fácil confundir dois clientes de nome parecido.

Preciso do CRAF e ele não está nos documentos do cliente. Documento de arma fica na arma. Abra a aba Acervo do dossiê, e o documento dentro da arma.