Laiá
Laiá é uma aplicação onde você será capaz de cadastrar, atualizar, acompanhar e disponibilizar publicamente o status dos seus pedidos de informação e denúncias.
Não sabe o que é um pedido de informação ou não sabe como fazer uma solicitação? Para saber mais, leia os artigos abaixo ⬇️
Nessa página você encontrará as seguintes insformações:
- Deploy
- Instalação e configuração do Laiá
- Criando pedidos de informação
- Criando denúncias
- Informações importantes
- Como contribuir
Instalação e configuração do Laiá
Para instalar e configurar o projeto, recomendamos acessar as instruções contidas no nosso repositório.
Criando pedidos de informação
Agora que o seu projeto está configurado, chegou a hora de criar usuários, inserir pedidos, órgãos e denúncias.
Como criar um usuário
Antes de criarmos novos usuários, pedidos, órgãos e denúncias, certifique-se que você configurou o seu super usuário no ambiente de produção. Sem o super usuário, não é possível acessar a página admmin do Laiá e consequentemente não será possível criar novos usuários, pedidos, órgãos e denúncias.
Agora que você já criou o seu super usuário, acesse a página admin com suas credenciais cadastradas.
A partir de agora, você poderá inserir novos usuários acessando a aba de Usuários.
Para criar um novo usuário, clique em ADICIONAR USUÁRIO e preencha as informações de acesso (usuário e senha).
Além de usuários, é possível criar Grupos, que se tornam ferramentas essenciais para conseguir gerenciar o nível de acesso e permissões de cada usuário cadastrado, evitando assim tanto o acesso como a deleção de informações de forma errada.
Para criar um grupo, acesse o menu à esquerda da página, em AUTENTICAÇÃO E AUTORIZAÇÃO, e clique em Grupos.
Nomeie o Grupo e selecione as permissões para esse grupo. No exemplo acima, estamos criando um Grupo onde, usuários pertencentes à ele serão capazes de visualizar, adicionar e atualizar pedidos, órgãos e denúncias. Outras ações como deleção desses campos não é permitida.
Com essa ferramenta, você é capaz de filtrar o nível de permissão para gerenciar usuários, grupos, sessão, permissão e log.
Para inserir usuários aos Grupos, basta acessar os usuários criados no menu de AUTENTICAÇÃO E AUTORIZAÇÃO, e incluí-los em um ou mais grupos. Note que é possível editar as Permissões do Usuário manualmente também.
Como criar um pedido de informação
Agora que os nossos usuários estão configurados, chegou a hora de criarmos os nossos pedidos de informação.
Você pode adicionar os pedidos individualmente ou múltiplos pedidos de uma vez só.
Adicionando um pedido
Para adicionar um pedido, acesse a página admin e clique em Pedidos.
Nessa Aba, você será capaz de visualizar todos os seus pedidos inseridos. Clicando em ADICIONAR PEDIDO, você acessará uma aba onde você irá preencher as informações do seu pedido. Note que os campos: Data de envio, Órgão, Título do Pedido, Meio de Contato e Texto são campos obrigatórios.
Caso o Órgão que você solicitou informações não conste nas opções, clique em “+” e um pop-up irá abrir. Preencha as informações do Órgão e salve suas alterações.
Com todas as informações preenchidas, clique em Salvar e pronto, você cadastrou um pedido!
Adicionando múltiplos pedidos
No Laiá, é possível adicionar múltiplos pedidos de uma vez através de um arquivo .csv padronizado. Para a importação dos seus pedidos ser bem sucedida, recomendamos criar uma planilha baseada neste exemplo.
Com a planilha criada, importe o arquivo para a raiz do projeto. E rode o seguinte comando para importá-la automaticamente:
docker-compose run --rm web python manage.py import <aqui-o-seu-arquivo>.csv
Quando a importação for finalizada, você receberá a seguinte mensagem:
Concluído! Foram inseridos n pedidos de informação.
Obs: Quando inserimos múltiplos pedidos, não é necessário adicionar os Órgãos manualmente, durante a importação da planilha os mesmos são criados automaticamente com informações básicas de Nome, Sigla e Esfera.
Criando denúncias
Além de criar novos usuários, órgãos e pedidos de informação, com o Laiá é possível registrar suas denúncias.
Denúncias são feitas quando há um descumprimento da Lei de Acesso à Informação aos órgãos de controle. Clique aqui e aqui para saber mais.
Para registrar uma denúncia no Laiá, acesse a página admin, e clique em Denúncias.
Clicando em ADICIONAR DENÚNCIA, você acessará uma aba onde você irá preencher as informações da sua denúncia. Note que os campos: Pedido, Data de Registro da denúncia, Título, Órgão, Meio de Contato e Texto são campos obrigatórios.
Com todas essas informações preenchidas, clique em Salvar e pronto, denúncia registrada com sucesso!
Informações importantes
-
Um pedido está sempre relacionado a um Órgão, portanto, a deleção de um Órgão só poderá ser feita se todos os pedidos associados a ele também forem deletados.
-
Uma denúncia está sempre relacionado a um Pedido, portanto, a deleção de um Pedido só poderá ser feita se as denúncias associadas a esse pedido também forem deletadas.
Como contribuir
Contribuições serão sempre muito bem-vindas e incentivadas! ✨
Se é a sua primeira vez contribuindo em um projeto open-source, sugerimos as seguintes leituras ⬇️
Para contribuir, acesse as nossas issues e entenda mais sobre as melhorias que queremos implementar.
Nossas issues são sinalizadas por tags, sugerimos a good first issue para quem está começando a contribuir.
Toda a comunicação e demais interações do Dados Abertos de Feira estão sujeitas ao nosso Código de Conduta.