Queremos Saber

Plataforma que permite o envio de pedidos pela Lei de Acesso à Informação sem revelar sua identidade.

Início rápido com Devbox

Com o Devbox instalado, um clone novo pode iniciar o Postgres, instalar as dependências, criar o .env, executar as migrações, compilar o CSS e subir a aplicação com um comando:

devbox run dev

Os dados e o socket do Postgres 16 ficam dentro deste checkout, enquanto os binários vêm do ambiente Devbox. O servidor aceita conexões apenas pelo socket Unix sob .devbox/, evitando conflitos com um Postgres do sistema ou com outros checkouts. Use devbox run db:stop para encerrá-lo; não inicie também o serviço PostgreSQL com devbox services up.

O bootstrap é idempotente e preserva qualquer .env existente. Outros comandos úteis são:

devbox run setup                    # prepara o ambiente sem subir o servidor
devbox run test                     # prepara o ambiente e executa os testes
devbox run -- make load_fixtures    # carrega os pedidos de exemplo
DEV_PORT=8001 devbox run dev        # usa outra porta para a aplicação

O Devbox precisa de uma instalação funcional do Nix. Se ele falhar com creating directory "/nix/store": Permission denied, configure o Nix em modo single-user ou habilite o daemon multi-user antes de tentar novamente.

Caso prefira configurar o ambiente manualmente, siga as instruções abaixo.

Instalando

Assumindo que você já tem o Python e uv instalados, instale as dependências com:

make install

Executando

1. Copie o .env.example para .env e altere as configurações (no mínimo, o DATABASE_URL)
2. Execute as database migrations com make migrate
3. Carregue as fixtures no seu banco de dados com make load_fixtures
4. Crie um superusuário com make create_admin
5. Execute make watch_sass em um terminal separado, para compilar o SASS para CSS
6. Rode o servidor com make server

A partir desse momento, você já pode acessar o projeto em http://localhost:8000.

Testes

Para rodar os testes, primeiro se certifique que seu usuário do postgres tenha permissões para criar um banco de dados e executar comandos no banco de dados.

sudo -u postgres psql
ALTER ROLE queremossaber WITH CREATEDB;

Isso permitirá que ele crie o banco de dados de testes durante sua execução. Uma vez isso esteja configurado, para rodar os testes basta executar:

make test

Pedidos de exemplo

Quando você carrega as fixtures no seu banco de dados, os seguintes pedidos de exemplo são criados:

• Rejeitado em moderação: SL6F4L46
• Aprovado mas não enviado: H4BRYOXF
• Respondido com um PDF: HQCYR6KQ
• Aguardando resposta atrasada do órgão público: GQ2XOQM7

Configurando uploads para Digital Ocean Spaces

Durante desenvolvimento, os arquivos enviados são salvos no filesystem local. Em produção, usamos o Digital Ocean Spaces. Para habilitá-lo, configure as variáveis que iniciam com AWS_ no arquivo .env e adicione ENABLE_S3=True.