UPDATE! [02/08/2022]: Novas alterações foram realizadas nos containers do SAPL e no docker-compose.yaml. Estas mudanças estarão funcionais a partir do próximo release. Enquanto isso não vem, continuem utilizando as versões antigas do docker-compose.yaml.
UPDATE! [02/08/2022]: Novas alterações foram realizadas nos containers do Legisinc e no docker-compose.yaml. Estas mudanças estarão funcionais a partir do próximo release. Enquanto isso não vem, continuem utilizando as versões antigas do docker-compose.yaml.
~~**UPDATE! [16/05/2022]: Devido a refatorações recentes no Solr, foi necessårio
adaptar o uso deste pelo SAPL. Para isso foram feitas mudanças no docker-compose.yml
adaptar o uso deste pelo Legisinc. Para isso foram feitas mudanças no docker-compose.yml
como a adição de um container para o ZooKeeper e upload de arquivo de segurança.
Recomendamos fortemente que para a versão 3.1.162 e superior do SAPL seja feito o backup do
Recomendamos fortemente que para a versão 3.1.162 e superior do Legisinc seja feito o backup do
Banco de Dados, limpeza dos containers no host (`sudo docker system prune -a -f --volumes`),
e consequente instalação dos novos containers a partir da execução do docker-compose. É
importante frisar que o comando `docker system prune` irá apagar TODOS os containers E
@ -18,7 +18,7 @@ TODOS os volumes (incluindo o BD) do host. Após o inicio dos novos containers,
com a restauração do BD, pare os containers e reinicie novamente para indexação textual.
Além disso, o docker-compose.yml foi movido para a pasta dist/ na raiz do projeto.**~~
Esta página reúne informações úteis sobre o desenvolvimento atual do SAPL.
Esta página reúne informações úteis sobre o desenvolvimento atual do Legisinc.
Isso significa que toda a informação aqui apresentada aplica-se apenas para a versão 3.1 e superior.
@ -27,12 +27,12 @@ Para obter mais informações sobre o projeto como um todo e a versão de trabal
atual do sistema (2.5), visite a página do `projeto na Interlegis wiki <https://colab.interlegis.leg.br/wiki/ProjetoSapl>`_.
**IMPORTANTE:** A partir da versão 3.1.162 do SAPL, as funcionalidades de recuperar senha,
**IMPORTANTE:** A partir da versão 3.1.162 do Legisinc, as funcionalidades de recuperar senha,
acompanhamento de matéria, e acompanhamento de documento exigirão o uso do `Google reCaptcha <https://www.google.com/recaptcha/>`_. Cada casa legislativa será responsável pela geração
das chaves do reCaptcha e configuração no SAPL em Sistema -> Parâmetros -> Configurações da Aplicação.
das chaves do reCaptcha e configuração no Legisinc em Sistema -> Parâmetros -> Configurações da Aplicação.
Sem essa configuração não serão habilitados os recursos citados anteriormente.
Veja mais detalhes sobre o processo de geração de chaves e configuração neste link https://www.youtube.com/watch?v=6ZCCyBjSJ-c
e no caderno de exercícios do SAPL 3.1 disponível na `Wiki do projeto <https://colab.interlegis.leg.br/wiki/ProjetoSapl3.1>`_
e no caderno de exercícios do Legisinc 3.1 disponível na `Wiki do projeto <https://colab.interlegis.leg.br/wiki/ProjetoSapl3.1>`_
Instalação do Ambiente de Desenvolvimento
=========================================
@ -46,12 +46,12 @@ Instalação do Solr
Instruções para Deploy
======================
`Deploy SAPL com Nginx + Gunicorn <https://github.com/interlegis/sapl/blob/3.1.x/docs/deploy.rst>`_
`Deploy Legisinc com Nginx + Gunicorn <https://github.com/interlegis/sapl/blob/3.1.x/docs/deploy.rst>`_
Instruções para Importação da base mysql 2.5
============================================
`Importação da Base do SAPL 2.5 para SAPL 3.1 <https://github.com/interlegis/sapl/wiki/Migra%C3%A7%C3%A3o-sapl-2.5-para-3.1>`_
`Importação da Base do Legisinc 2.5 para Legisinc 3.1 <https://github.com/interlegis/sapl/wiki/Migra%C3%A7%C3%A3o-sapl-2.5-para-3.1>`_
Instruções para Tradução
@ -72,7 +72,7 @@ Orientações gerais sobre o GitHub
Suporte ao utilizadores
===================================
`Sala do Discord "Somos Interlegis" sobre SAPL <https://discord.gg/fzXSbhZbcy>`_
`Sala do Discord "Somos Interlegis" sobre Legisinc<https://discord.gg/fzXSbhZbcy>`_
@ -29,7 +29,7 @@ Os mantenedores do projeto têm o direito e a responsabilidade de remover, edita
Este Código de Conduta aplica-se tanto nos espaços do projeto quanto nos espaços públicos quando um indivíduo representa o projeto ou sua comunidade. Exemplos de representar um projeto ou comunidade incluem o uso de um endereço de e-mail oficial do projeto, postagem através de uma conta oficial em mídias sociais, ou atuando como representante designado em um evento online ou offline. A representação de um projeto pode ser melhor definida e esclarecida pelos responsáveis pelo projeto.
## Execução
Instâncias de comportamento abusivo, de assédio ou de outra forma inaceitável podem ser comunicadas ao contactar a equipe do projeto através do COLAB do Interlegis para o projeto do SAPL, todas as informações podem ser acessadas através [deste link](https://colab.interlegis.leg.br/wiki/ProjetoSapl).
Instâncias de comportamento abusivo, de assédio ou de outra forma inaceitável podem ser comunicadas ao contactar a equipe do projeto através do COLAB do Interlegis para o projeto do Legisinc, todas as informações podem ser acessadas através [deste link](https://colab.interlegis.leg.br/wiki/ProjetoSapl).
A equipe do projeto irá rever e investigar todas as queixas, e responderá da forma que julgar apropriada às circunstâncias.
A equipe do projeto buscará manter a confidencialidade em relação ao repórter de um incidente. Mais detalhes sobre políticas de execução específicas podem ser publicados separadamente.
Caso queira contribuir com o projeto, talvez seja uma boa ideia começar pelo [README](https://github.com/interlegis/sapl) para conhecer melhor sobre nós.
Outro documento importante e que deve ser lido é o [Código de Conduta](https://github.com/interlegis/sapl/blob/3.1.x/docs/CODE_OF_CONDUCT.md).
O **SAPL** é um sistema web completo para gerenciamento de processos legislativos em casas legislativas municipais, estaduais e federais. Desenvolvido pelo Interlegis (Senado Federal), o sistema abrange todo o ciclo de vida legislativo, desde o cadastro de parlamentares até a votação e publicação de normas jurídicas.
O **Legisinc** é um sistema web completo para gerenciamento de processos legislativos em casas legislativas municipais, estaduais e federais. Desenvolvido pelo Interlegis (Senado Federal), o sistema abrange todo o ciclo de vida legislativo, desde o cadastro de parlamentares até a votação e publicação de normas jurídicas.
**Versão Atual**: 3.1.164-RC5
@ -41,7 +41,7 @@ O **SAPL** é um sistema web completo para gerenciamento de processos legislativ
## Módulos Principais
O SAPL está organizado em 9 módulos principais:
O Legisinc está organizado em 9 módulos principais:
### 1. **Base** (`sapl.base`)
- Configurações gerais do sistema
@ -285,7 +285,7 @@ Antes de começar a usar o sistema para criar dados, é necessário configurar:
sapl/
├── docker/ # Configurações Docker
│ ├── docker-compose.yaml # Orquestração de containers
│ └── Dockerfile # Imagem do SAPL
│ └── Dockerfile # Imagem do Legisinc
├── frontend/ # Código frontend (Vue.js)
│ ├── src/
│ │ ├── __global/ # Estilos e componentes globais
@ -339,7 +339,7 @@ yarn build
## API REST
O SAPL disponibiliza uma API REST completa para integração com outros sistemas.
O Legisinc disponibiliza uma API REST completa para integração com outros sistemas.
@ -384,11 +384,11 @@ O SAPL disponibiliza uma API REST completa para integração com outros sistemas
## Tipos de Usuários e Permissões
O SAPL possui um sistema robusto de controle de acesso com **11 grupos de usuários** diferentes, cada um com permissões específicas para módulos e funcionalidades.
O Legisinc possui um sistema robusto de controle de acesso com **11 grupos de usuários** diferentes, cada um com permissões específicas para módulos e funcionalidades.
- não use ``django.contrib.auth.models.User`` para utilizar as caracteristicas do model, para isso, use esta função: django.contrib.auth.get_user_model()
- Seguir esses passos simplificará qualquer customização futura que venha a ser feita na autenticação do usuários ao evitar correções de inúmeros import's e ainda, desta forma, torna a funcionalidade de autenticação reimplementável por qualquer outro projeto que venha usar partes ou o todo do SAPL.
- Seguir esses passos simplificará qualquer customização futura que venha a ser feita na autenticação do usuários ao evitar correções de inúmeros import's e ainda, desta forma, torna a funcionalidade de autenticação reimplementável por qualquer outro projeto que venha usar partes ou o todo do Legisinc.
O comando acima irá clonar a última versão estável do SAPL (3.1.x)
O comando acima irá clonar a última versão estável do Legisinc (3.1.x)
Para clonar todo o repositório utilize o comando abaixo:
git clone git://github.com/interlegis/sapl
@ -87,7 +87,7 @@ Clonar o projeto do github, ou fazer um fork e depois clonar
* As configurações e instruções de uso para o git estão espalhadas pela internet e possui muito coisa bacana. As tarefas básicas de git e suas interações com github são tranquilas de se aprender.
Criar o ambiente virtual de desenvolvimento para o SAPL
Criar o ambiente virtual de desenvolvimento para o Legisinc
* Obs: no ambiente de desenvolvimento, a role deve ter permissão para criar outro banco. Isso é usado pelos testes automatizados.
* (caso você já possua uma instalação do postrgresql anterior ao processo de instalação do ambiente de desenvolvimento do SAPL em sua máquina e sábia como fazer, esteja livre para proceder como desejar, porém, ao configurar o arquivo ``.env`` no próximo passo, as mesmas definições deverão ser usadas)
* (caso você já possua uma instalação do postrgresql anterior ao processo de instalação do ambiente de desenvolvimento do Legisinc em sua máquina e sábia como fazer, esteja livre para proceder como desejar, porém, ao configurar o arquivo ``.env`` no próximo passo, as mesmas definições deverão ser usadas)
* **Ajustar as permissões - onde $USER trocar por usuário**::
@ -181,7 +181,7 @@ Copie a chave que aparecerá, edite o arquivo .env e altere o valor do parâmetr
./manage.py runserver 0.0.0.0:8001
* Acesse o SAPL em::
* Acesse o Legisinc em::
http://localhost:8001/
@ -192,11 +192,11 @@ Instruções para criação do super usuário e de usuários de testes
python3 manage.py createsuperuser
* `Os perfis semânticos do SAPL <https://github.com/interlegis/sapl/blob/master/sapl/rules/__init__.py>`_ são fixos e atualizados a cada execução do comando::
* `Os perfis semânticos do Legisinc<https://github.com/interlegis/sapl/blob/master/sapl/rules/__init__.py>`_ são fixos e atualizados a cada execução do comando::
./manage.py migrate
* Os perfis fixos não aceitam customização via admin, porém outros grupos podem ser criados. O SAPL não interferirá no conjunto de permissões definidas em grupos customizados e se comportará diante de usuários segundo seus grupos e suas permissões.
* Os perfis fixos não aceitam customização via admin, porém outros grupos podem ser criados. O Legisinc não interferirá no conjunto de permissões definidas em grupos customizados e se comportará diante de usuários segundo seus grupos e suas permissões.
* Para criar os usuários de teste, deve-se seguir os seguintes passos::
@ -217,7 +217,7 @@ Instruções para criação do super usuário e de usuários de testes
operador_painel
Frontend do SAPL
Frontend do Legisinc
=============
* Se seu objetivo é preparar o ambiente de desenvolvimento para colaborar com o backend, você não precisa se preocupar com o tutorial abaixo pois na pasta https://github.com/interlegis/sapl/tree/3.1.x/sapl/static/sapl/frontend já está o código oficial de produção do Frontend
**O servidor do Solr NÃO DEVE SER EXPOSTO NA INTERNET. Assim como o servidor de bancos de dados Postgres ele deve estar acessível pelo SAPL na rede interna (atrás de NATs/firewalls/proxies/etc).**
**O servidor do Solr NÃO DEVE SER EXPOSTO NA INTERNET. Assim como o servidor de bancos de dados Postgres ele deve estar acessível pelo Legisinc na rede interna (atrás de NATs/firewalls/proxies/etc).**
Solr é uma plataforma open source de indexação e busca textual utilizada pelo SAPL 3.1 para indexar documentos (normas jurídicas, matérias legislativas e documentos acessórios).
Solr é uma plataforma open source de indexação e busca textual utilizada pelo Legisinc 3.1 para indexar documentos (normas jurídicas, matérias legislativas e documentos acessórios).
Observação: Se a execução do SAPL for mediante containers Docker então use o arquivo *docker-compose.yml* disponível em
*https://github.com/interlegis/sapl/blob/3.1.x/dist/docker-compose.yml* (verifique os mapeamentos de volume estão corretos, a verso do SAPL referenciada no arquivo docker-compose.yml, e realize o backup de seu BD **antes** de qualquer tentativa de substituição do arquivo *docker-compose.yml* em uso corrente);
Observação: Se a execução do Legisinc for mediante containers Docker então use o arquivo *docker-compose.yml* disponível em
*https://github.com/interlegis/sapl/blob/3.1.x/dist/docker-compose.yml* (verifique os mapeamentos de volume estão corretos, a verso do Legisinc referenciada no arquivo docker-compose.yml, e realize o backup de seu BD **antes** de qualquer tentativa de substituição do arquivo *docker-compose.yml* em uso corrente);
1) Faça o download da distribuição *binária* do Apache Solr do site oficial do projeto **http://lucene.apache.org/solr**
@ -25,7 +25,7 @@ Observação: Se a execução do SAPL for mediante containers Docker então use
4) Por meio do browser, acesse a URL **http://localhost:8983** (ou informe o endereço da máquina onde o Solr foi instalado)
5) Pare o servidor do SAPL;
5) Pare o servidor do Legisinc;
6) Edite o arquivo .env adicionando as seguintes linhas:
@ -40,11 +40,11 @@ Observação: Se a execução do SAPL for mediante containers Docker então use
(o valor do campo SOLR_URL deve corresponder à URL acessada no item 3)
7) Entre no diretório raiz do SAPL e digite o comando: **python3 solr_api.py -c sapl -u http://localhost:8983`**
7) Entre no diretório raiz do Legisinc e digite o comando: **python3 solr_api.py -c sapl -u http://localhost:8983`**
(a URL informada acima deve ser a mesma dos itens 3 e 6)
8) Enquanto o Solr realiza a indexação da base de dados do SAPL, inicie em uma outra tela o SAPL;
8) Enquanto o Solr realiza a indexação da base de dados do Legisinc, inicie em uma outra tela o Legisinc;
9) Após realizados os passos com sucesso, nas telas de busca de Matéria Legislativa e Normas deverá aparecer um botão
de 'Pesquisa Textual' na tela de busca tradicional.
@ -73,7 +73,7 @@ de 'Pesquisa Textual' na tela de busca tradicional.
1. Uma dúvida quanto a indexação do Solr, pelo que entendi de tempos e tempos tenho que rodar o comando para poder indexar novos arquivos certo?
Errado. Cada novo documento inserido, atualizado, ou removido do SAPL dispara uma nova indexação somente daquele documento no Solr automaticamente.
Errado. Cada novo documento inserido, atualizado, ou removido do Legisinc dispara uma nova indexação somente daquele documento no Solr automaticamente.
2. O comando **python3 solr_api.py -c sapl -u http://localhost:8983** indexa os novos arquivos?
@ -81,7 +81,7 @@ de 'Pesquisa Textual' na tela de busca tradicional.
3. Ou teria que reindexar do zero com *rebuild_index*?
Pode acontecer do Postgres e o Solr se dessincronizarem (ex: o Solr ficou fora do ar por um dia e foram inseridos registros no SAPL). Ou por algum motivo se deseja refazer o índice do Solr. Neste caso pode-se refazer a indexação no Solr com o comando : **python3 manage.py rebuild_index** (direto na linha de comando, a partir da pasta raiz do SAPL). Mas existem maneiras de atualizar somente os documentos inseridos/alterados a partir de uma determinada data ao invés de atualizar tudo do zero de novo.
Pode acontecer do Postgres e o Solr se dessincronizarem (ex: o Solr ficou fora do ar por um dia e foram inseridos registros no Legisinc). Ou por algum motivo se deseja refazer o índice do Solr. Neste caso pode-se refazer a indexação no Solr com o comando : **python3 manage.py rebuild_index** (direto na linha de comando, a partir da pasta raiz do Legisinc). Mas existem maneiras de atualizar somente os documentos inseridos/alterados a partir de uma determinada data ao invés de atualizar tudo do zero de novo.
4. Pergunto isso pois estou querendo criar um script para crontab para indexar esses novos arquivos
Nós utilizamos o `Transifex <https://www.transifex.com>`_ para gerenciar as traduções do projeto.
Se você deseja contribuir, por favor crie uma conta no site e peça para se juntar a nós em `Transifex SAPL Page <https://www.transifex.com/projects/p/sapl>`_.
Se você deseja contribuir, por favor crie uma conta no site e peça para se juntar a nós em `Transifex Legisinc Page <https://www.transifex.com/projects/p/sapl>`_.
Assim que for aceito, você já pode começar a traduzir.
Para integrar as últimas traduções ao projeto atual, siga estes passos:
tmp+='\t\t\t\t<drawString x="4.2cm" y="25cm">Pauta da '+str(inf_basicas_dic['num_sessao_plen'])+'ª Reunião '+str(inf_basicas_dic['nom_sessao'])+' da '+str(
inf_basicas_dic['num_sessao_leg'])+'ª Sessão Legislativa da </drawString>\n'
tmp+='\t\t\t\t<drawString x="4.2cm" y="25cm">Resumo da '+str(inf_basicas_dic['num_sessao_plen'])+'ª Reunião '+str(inf_basicas_dic['nom_sessao'])+' da '+str(
inf_basicas_dic['num_sessao_leg'])+'ª Sessão Legislativa da </drawString>\n'
@ -42,14 +42,14 @@ para a impressão, sem as margens laterais e superior. Para
imprimir o texto desejado utilize a função
Impressão do browser que estiver usando.<br/>
A opção “Ajuda” contem o
manual do sistema SAPL.<br/>
manual do sistema Legisinc.<br/>
As opções, Impressão, Ajuda e
Consultas por palavra chave, estão presentes em todas as
telas do sistema.<br/>
O item “Copyright Interlegis” contem a
licença de uso, cópia,
distribuição e modificação
do Sistema de Apoio ao Processo Legislativo.<br/>
do Legisinc.<br/>
<br/>
<h2><aNAME="cons_cons">Consultas</a></h2>
<br/>
@ -641,7 +641,7 @@ Um asterisco é um operador de truncamento. Diferente dos outros operadore
A frase que é colocada entre aspas duplas “, coincide apenas com registros que contenham esta frase literalmente, como foi digitada. <br/>
“desafetação de área pública“<br/>
... não apresenta “desafetação de áreas públicas“ . <br/><br>
A partir da versão 2.0 do SAPL passou a ser
A partir da versão 2.0 do Legisinc passou a ser
possível também a <span
style="font-weight: bold;">pesquisa por palavra contida no
texto da norma jurídica</span>. Basta informar a
@ -97,7 +97,7 @@ Um asterisco é um operador de truncamento. Diferente dos outros operadore
A frase que é colocada entre aspas duplas “, coincide apenas com registros que contenham esta frase literalmente, como foi digitada. <br/>
“desafetação de área pública“<br/>
... não apresenta “desafetação de áreas públicas“ . <br/><br>
A partir da versão 2.0 do SAPL passou a ser
A partir da versão 2.0 do Legisinc passou a ser
possível também a <span
style="font-weight: bold;">pesquisa por palavra contida no
<pclass="lead mb-4">Cada grupo de permissões concede acesso a funcionalidades específicas do SAPL. Selecione os grupos adequados conforme as responsabilidades do usuário.</p>
<pclass="lead mb-4">Cada grupo de permissões concede acesso a funcionalidades específicas do Legisinc. Selecione os grupos adequados conforme as responsabilidades do usuário.</p>
<li>Após usar a opção DVt, alterações manuais poderão ser feitas no Editor Avançado e, não sendo usado novamente a opção Dvt, essas alterações manuais serão mantidas.</li>
</ol>
</li>
<li>A criação de Tipos de Dispositivos é dinâmica e deverão estar amarrados por perfis estuturais configuráveis. Por serem tarefas técnicas e complicadas, criar/editar tipos de dispositivos e perfis estuturais estão disponíveis apenas na área de edição técnica do SAPL (admin).
<li>A criação de Tipos de Dispositivos é dinâmica e deverão estar amarrados por perfis estuturais configuráveis. Por serem tarefas técnicas e complicadas, criar/editar tipos de dispositivos e perfis estuturais estão disponíveis apenas na área de edição técnica do Legisinc (admin).
{% block head_title %}Guia do Projeto SAPL - {{nome_casa}}{% endblock %}
{% block head_title %}Guia do Projeto Legisinc - {{nome_casa}}{% endblock %}
{% block base_content %}
<style>
@ -212,11 +212,11 @@
</style>
<divclass="guia-projeto">
<h1><iclass="fas fa-book"></i> Guia do Projeto SAPL</h1>
<h1><iclass="fas fa-book"></i> Guia do Projeto Legisinc</h1>
<divclass="alert">
<strong><iclass="fas fa-info-circle"></i> Sobre este Guia:</strong>
Este documento contém informações completas sobre a arquitetura, módulos, fluxos de trabalho e permissões do Sistema de Apoio ao Processo Legislativo (SAPL).
Este documento contém informações completas sobre a arquitetura, módulos, fluxos de trabalho e permissões do Legisinc.
O <strong>SAPL</strong> é um sistema web completo para gerenciamento de processos legislativos em casas legislativas municipais, estaduais e federais.
O <strong>Legisinc</strong> é um sistema web completo para gerenciamento de processos legislativos em casas legislativas municipais, estaduais e federais.
Desenvolvido pelo Interlegis (Senado Federal), o sistema abrange todo o ciclo de vida legislativo, desde o cadastro de parlamentares até a votação e publicação de normas jurídicas.
rangelbruno
10 months ago