Instalação e Configurações

Apps

Clonar repositório do programa de gestão <https://gitlab.ifrn.edu.br/>

git clone git@gitlab.ifrn.edu.br:cosinf/suap-ifgoiano.git

Nota

Para realizar a clonagem, deve-se adicionar a chave SSH ao seu perfil no Gitlab.

Copiar as apps: programa_gestao, pgd_api, pgd_integra_ifgoiano

App programa_gestao: implementa toda a lógica de negócio do PGD.

App pgd_api: implementa a integração com a API do PGD <https://api-programadegestao.economia.gov.br/docs>

App pgd_integra_ifgoiano: implementa a integração entre os dados da app programa_gestao e o envio através app pgd_api. Permite e visualização do histórico de envio dos planos cadastrados na app programa_gestao.

  • arquivo integra/configuracao.py: implementa a lista das situações dos planos e atividades aptas para envio pela app pgd_api.

  • arquivo integra/dados.py: implementa a obtenção de cada dado a ser enviado pela pgd_api.

  • arquivo integra/integra.py: envia os dados pela API utilizando a app pgd_api.

  • arquivo management/commands/pgd_integra_ifgoiano_enviar_dados.py: chama rotina de envio de dados pela app pgd_api. Comando deve ser inserido no sync_suap.py da instituição.

  • model PlanodeTrabalhoPgdIfgoiano: proxy para model PlanodeTrabalho da app programa_gestao que implementa métodos adicionais

Habilitar aplicações no arquivo de configuração do SUAP (suap/settings.py)

INSTALLED_APPS_SUAP = (
.
.
.
.
'programa_gestao',
'pgd_api',
'pgd_integra_ifgoiano'
)

Sincronizar SUAP

python manage.py sync

API

Solicitar as credenciais via e-mail para pgd@economia.gov.br, com as seguintes informações:

  • Nome responsável pela integração:

  • E-mail

  • Matrícula SIAPE

  • Código SIORG do órgão

  • Sistema utilizado

Acesse a URL </comum/configuracao> no SUAP para configurar a API. Localize a seção «Aplicação pgd_integra_ifgoiano» e informe os dados:

  • URL da API

  • Usuário API PGD Ministério da Economia

  • Senha API PGD Ministério da Economia

Para testar, pode rodar individualmente o comando «pgd_integra_ifgoiano_enviar_dados»:

python manage.py pgd_integra_ifgoiano_enviar_dados

Nota

O comando deverá ser adicionado ao comando sync_suap da instituição para rodar periodicamente.

URLs

admin/pgd_integra_ifgoiano/registroacaoenvioplanodetrabalho/: visualizar registro de envios dos planos

admin/pgd_integra_ifgoiano/planodetrabalho:

  • visualizar os planos de trabalho aptos a serem enviados;

  • visualizar situação de envio de cada plano;

  • enviar planos individualmente.

Comandos

Atualização faixa de complexidade

Este comando é para instituições que adotaram o módulo com a modelagem antiga, onde o campo da faixa de complexidade estava na tabela de atividades. Instituições que vão começar a utilizar o módulo após 07/10/2022 não precisam migrar dados e pode ignorar o comando. Para realizar a migração dos planos já enviados deve-se seguir os seguintes passos:

  • Descomentar os campos tempo_execucao_presencial, tempo_execucao_remota, faixa_complexidade, parametros_complexidade e ganho_produtividade e método save do modelo Atividade

  • A fixture programa_gestao/fixture/complexidade.json foi criada de acordo com as faixas de complexidade adotadas no IF Goiano, deve ser verificado se o mesmo cadastro será utilizado.

  • Aplicar individualmente a migração manage.py migrate programa_gestao 0006_auto_20220323_1106. Ela cria o novo modelo Complexidade e popula com a fixture complexidade.json.

  • O comando atualizar_faixa_complexidade faz um de-para na faixa de complexidade e deve ser analisado se atende a realidade da instituição.

  • Acessar o arquivo programa_gestao/migrations/0007_auto_20220323_1542 e descomentar a linha 16. Essa linha roda o comando para atualizar a faixa de complexidade quando aplicar a migração.

  • Aplicar individualmente a migração manage.py migrate programa_gestao 0007_auto_20220323_1542. Ela executa o comando atualizar_faixa_complexidade e remove os campos do modelo Atividade.

  • Apagar os campos e o método save do modelo Atividade.

Fechar planos automaticamente

Este comando finaliza os planos e homologa a carga-horária para planos avaliados a mais de sete dias. Pode ser agendado no cron periodicamente ou adicionado no sync_suap da instituição. Para executar o comando:

python manage.py fechar_plano_automaticamente

Migrar modalidade do edital para inscrição

Este comando é para instituições que adotaram o módulo com a modelagem antiga, onde o campo de modalidade do programa de gestão estava na tabela de editais. Instituições que vão começar a utilizar o módulo após 07/10/2022 não precisam migrar dados e podem ignorar o comando. Para realizar a migração das inscrições deve-se executar o comando:

python manage.py migrar_modalidade_edital_para_inscricao

Notificar autorização atrasada

Este comando notifica todas as chefias imediatas sobre planos encaminhados e não autorizados após 2 dias. Pode ser agendado no cron periodicamente ou adicionado no sync_suap da instituição. Para executar o comando:

python manage.py notificar_autorizacao_atrasada

Notificar avaliação atrasada

Este comando notifica todas as chefias imediatas sobre planos entregues e não avaliados após 40 dias. Pode ser agendado no cron periodicamente ou adicionado no sync_suap da instituição. Para executar o comando:

python manage.py notificar_avaliacao_atrasada

Notificar entrega atrasada

Este comando notifica todos os servidores participantes do programa de gestão sobre planos autorizados e não entregues após 3 dias da data de finalização do plano. Pode ser agendado no cron periodicamente ou adicionado no sync_suap da instituição. Para executar o comando:

python manage.py notificar_avaliacao_atrasada

Desativar servidores com máximo de faltas

Este comando desliga do programa da gestão as inscrições de edital vigente que atingiram o número máximo de faltas. Pode ser agendado no cron periodicamente ou adicionado no sync_suap da instituição. Para executar o comando:

python manage.py desativar_servidores_com_maximo_faltas