Skip to content

Repository files navigation

Estandarte do Rationarium

Rationarium — Plataforma de Gestão Pública Municipal

Licença Tecnologia Banco Acesso Implantação Estado CI

Descrição

O Rationarium é a plataforma web que sucede a família de sistemas de desktop para prefeituras: um sistema só, multiusuário, hospedado, com módulos habilitáveis por cliente — contratação direta, contratos e atas, almoxarifado, documentos oficiais e o acervo do PNCP. Cada prefeitura roda numa instância isolada (container + banco próprios); nenhum dado de um município convive com o de outro.

O problema que resolve: a família de sistemas anterior (SGCD, SGCA, SGEA, SGDP, Licitarium) provou o valor de cada módulo isoladamente, rodando local, um usuário por vez. O Rationarium consolida esse conhecimento de domínio numa plataforma de produção de verdade — login com papéis, auditoria de tudo que se grava, backup do lado do operador, atualização por imagem.

Rationarium: do latim ratio (conta, razão) + -arium — o livro-mestre das contas públicas, como o rationarium imperii que Augusto deixou ao Senado. RES PVBLICA · RATIO CERTA.

Módulos

Módulo Função Estado
Licitarium Acervo PNCP do município, banco de preços (art. 23), relatórios ao TCE, Montar PCA ativo — porte completo do desktop, dados reais
Emptorium Contratação direta — dispensas, controle de fracionamento, integração PNCP em construção
Pactarium Contratos e atas de registro de preços em construção
Horreum Almoxarifado — lote, validade, FEFO em construção
Scrinium Documentos oficiais da Procuradoria — leis, decretos, portarias, pareceres em construção

Arquitetura

Uma instância por prefeitura (Docker Compose: app + Postgres), reverse proxy Caddy com HTTPS automático por subdomínio. Frontend em templates Django + JavaScript vanilla — sem SPA, sem build de frontend — exceto o módulo Licitarium, que herda a interface validada do desktop trocando só o transporte (fetch no lugar da ponte pywebview).

config/            settings, urls — configuração da instância
core/               usuários, papéis, auditoria, design system (3 temas)
modulos/licitarium/ acervo PNCP portado do desktop (ponte, serviços, UI)
deploy/             Dockerfile, compose, Caddyfile, provisionamento
tests-e2e/          Playwright — pilha real contra Postgres semeado

Decisões de arquitetura e o porte do Licitarium: DESIGN.md e modulos/licitarium/PORTE.md.

Estado

F0 e F1 concluídas. Núcleo pronto (usuários com papéis, auditoria imutável, gestão de conta com CPF/telefone/órgão) e o módulo Licitarium rodando de ponta a ponta — painel, banco de preços, relatórios, sync PNCP — validado contra o acervo real de um piloto. F2 (infraestrutura de produção: VPS, backup, provisionamento) planejada, ainda não iniciada.

A família de sistemas de desktop que antecede esta plataforma continua disponível, em modo estável: SGCD, SGCA, SGEA, SGDP e o Licitarium desktop (edição comunitária gratuita — desenvolvimento ativo migrou para cá).

Desenvolvimento

python -m venv .venv && .venv/Scripts/pip install -r requirements-dev.txt
python manage.py migrate
python manage.py runserver          # http://localhost:8000

python -m pytest                    # núcleo + módulos
npm install && npx playwright test  # E2E contra Postgres real

docker build -f deploy/Dockerfile -t rationarium .   # artefato de produção

A cada push, o CI roda pytest + Playwright contra um Postgres real e faz o build (com smoke test) da imagem de produção.

Sistemas irmãos

Sistema Cuida de
Rationarium — Plataforma web sucessora hospedada da família, módulos habilitáveis (este)
Licitarium — Repositório do PNCP edição desktop, modo estável repositório
Peculium — Patrimônio Pessoal carteira de investimentos, custos e imposto, desktop repositório
SGCD / SGCA / SGEA / SGDP contratação, contratos, almoxarifado, documentos — desktop, single-file devtulio

Licença

AGPL-3.0 — © 2026 Túlio Ribeiro de Moura e Silva. Código aberto de verdade: use, estude, modifique — e se hospedar para terceiros, devolva as modificações.

About

Plataforma modular de gestão pública municipal — sucessora hospedada da família SGx (Django, PostgreSQL, Docker, AGPL-3.0). RES PVBLICA · RATIO CERTA.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages