i-Educar - 1º Seminário PHP no Serpro

Líder em soluções de TI para governo

Sistema de Gestão Escolar

Carlos M. dos SantosCoordenação Estratégica de Ações Governamentais - CEAGO

1º Seminário de PHP da SERPRO9 de novembro de 2015

Agenda

● Introdução

● Histórico

● Situação atual

● Arquitetura de código

● Contribuições do SERPRO

Introdução

● Software de gestão escolar

● Desenvolvido inicialmente pela Prefeitura de Itajaí, SC

● Software Livre

● Desenvolvimento ativo

Software livre

● Portal do Software Público Brasileiro (SPB)

● Disponível sob licença GPL

● http://softwarepublico.gov.br

Histórico

● 2006/2007

● Criação do SoftwareCTIMA – Prefeitura Municipal de Itajaí

● 2008

● Portal do Software Público Brasileiro

● Parceria com Cobra Tecnologia

● 2010/2011

● Comunidade ativa

● Portabilis Tecnologia

● 2014/2015

● Parceria – SERPRO, Ieducativa Soluções e Portabilis Tecnologia

● Trabalho unificado no novo Portal do SPB

Evolução

● CTIMA/Prefeitura de Itajaí

● Desenvolvimento do software

● Cobra Tecnologia

● Refatoração e criação de arquitetura em framework

● Portabilis Tecnologia

● Novas funcionalidades, modelo Software as a Service (SaaS)

● SERPRO

● Migração para PostgreSQL 9.X

● Produção a ser feita em modelo Infrastructure as a Service (IaaS)

● Importação Educacenso

Quem usa?

●Araranguá/SC●Arapiraca/AL●Balneário Arroio do Silva/SC●Balneário Gaivota/SC●Balneário Rincão/SC●Benevides/PA●Bonito/MS●Botucatu/SP●Cocal do Sul/SC●Colégio Tiradentes da Brigada Militar Passo Fundo/RS●Dom Eliseu/PA●Esplanada/BA●Estado de Alagoas●Florianópolis/SC●Grão Pará/SC●Içara/SC●Irecê/BA●Instituto Mãos de Arte Paranoá/DF●Itajaí/SC●Jacinto Machado/SC●Jaguaruna/SC●Lagoa Grande/PE●Laguna/SC●Maracajá/SC●Meleiro/SC

● Montes Claros/MG● Natuba/PB● Nova Veneza/SC● Pacajá/PA● Pescaria Brava/SC● Praia Grande/SC● Polícia Militar da Paraíba● Sangão/SC● Santa Rosa do Sul/SC● São Francisco do

Conde/BA● Sombrio/SC● Timbé do Sul/SC● Sombrio/SC● Valparaíso de Goiás/GO

Programa Cidades Digitais

● Ministério das ComunicaçõesSecretaria de Inclusão Digital

● 362 municípios contemplados

● Infraestrutura de acesso

● Softwares de Gestão Pública

Quem o SERPRO atende?

Valparaíso de GoiásAcordo de Cooperação

Viçosa do CearáPrograma Cidades Digitais

Módulos principais

● Escola

● Cadastros: Controle de alunos, turmas, matrículas, ...

● Movimentações: Controle de notas, frequência, ...

● Documentos: Emissão de boletins, atestados, certificados, …

● Biblioteca

● Controle de empréstimos

● Inventário do acervo

● Transporte escolar

● Cadastro de prestadores e veículos

● Controle de rotas oferecidas

● Agenda

● Gestão de Pessoas

Funcionalidades

● Cadastros

● Funcionários, endereçamento, alunos, escolas, material didático, ...

Funcionalidades

● Operacional

● Matrículas, lançamentos de notas e faltas, calendário letivo, ...

Funcionalidades

● Gerenciamento de biblioteca

● Acervo, controle de empréstimos, ...

Transporte Escolar

Funcionalidades

● Documentos

● Emissão de boletins, relatórios gerenciais e atestados de vaga e matrícula, ...

Benefícios

● Menor despesa com sistemas de informação

● Automação dos procedimentos de gestão escolar

● Redução do uso de papel

● Centralização dos cadastros

● Gestão unificada da rede de ensino

● Frequente evolução do software na comunidade

Demonstração

i-Educar na prática

Arquitetura de código

“Talk is cheap. Show me the code.”Linus Torvalds

Três gerações de código

● 1ª – Gerador de código (ewwww...)

● 2ª – Framework próprio

● 3ª – Migração para API

Exploração arqueológica do código

● Aplicação da intranet da Prefeitura de Itajaí

● Stack em Linux, PostgreSQL (8.2!), PHP e Apache HTTPD

● Diversos sistemas de controle integrados

● Charset ISO-8859-1

Código antigo – DAOs primitivos

<?php

class clsPessoaFisica extends clsPessoaFj { var $idpes; var $data_nasc; var $sexo; var $data_obito; var $nacionalidade; var $idmun_nascimento;

function clsPessoaFisica($int_idpes = FALSE, $numeric_cpf = FALSE, $date_data_nasc = FALSE, $str_sexo = FALSE, …);

function lista($str_nome = FALSE, $numeric_cpf = FALSE, $inicio_limite = FALSE, $qtd_registros = FALSE, $str_orderBy = FALSE, …);

function detalhe();

function excluir();

}

?>

Código antigo – Templates simples

<table summary="" class='tabelanum2' border='0' cellspacing='0' cellpadding='0'>

<tr><td class="r3c1" width='170'></td><td valign=top>

<table summary="" class='tabelanum2' border='0' cellspacing='0' cellpadding='0'>

<tr><td height="0" id="menu_suspenso">

<input type="hidden" value="" id="posx"><input type="hidden" value="" id="posy">

</td></tr><tr>

<td height="100%" valign="top" id="corpo"></td>

</tr></table>

</td></tr>

</table>

Código antigo – Um arquivo .php por página

<?php

class clsIndex extends clsBase {function Formular() {

$this->SetTitulo( "Pessoas Físicas" );$this->processoAp = 43;

$this->addEstilo( "localizacaoSistema" );}

}

class indice extends clsListagem {function Gerar() { /* retorna um monte de HTML em texto */ }

}

$pagina = new clsIndex();

$miolo = new indice();$pagina->addForm( $miolo );

$pagina->MakeAll();

?>

Código antigo – Banco de dados

CREATE TABLE endereco_externo ( idpes numeric(8,0) NOT NULL, tipo numeric(1,0) NOT NULL, idtlog character varying(5) NOT NULL, logradouro character varying(150) NOT NULL, numero numeric(6,0), letra character(1), complemento character varying(20), bairro character varying(40), cep numeric(8,0), cidade character varying(60) NOT NULL, sigla_uf character(2) NOT NULL, reside_desde date, idpes_rev numeric, data_rev timestamp without time zone, origem_gravacao character(1) NOT NULL, idpes_cad numeric, data_cad timestamp without time zone NOT NULL, operacao character(1) NOT NULL, bloco character varying(20), andar numeric(2,0), apartamento numeric(6,0), idsis_rev integer, idsis_cad integer NOT NULL, zona_localizacao integer DEFAULT 1, CONSTRAINT ck_endereco_externo_operacao CHECK ((((operacao = 'I'::bpchar) OR (operacao = 'A'::bpchar)) OR (operacao = 'E'::bpchar))), CONSTRAINT ck_endereco_externo_origem_gravacao CHECK (((((origem_gravacao = 'M'::bpchar) OR (origem_gravacao = 'U'::bpchar)) OR (origem_gravacao = 'C'::bpchar)) OR (origem_gravacao = 'O'::bpchar))), CONSTRAINT ck_endereco_externo_tipo CHECK (((tipo >= (1)::numeric) AND (tipo <= (3)::numeric))));

CREATE TABLE endereco_pessoa ( idpes numeric(8,0) NOT NULL, tipo numeric(1,0) NOT NULL, cep numeric(8,0) NOT NULL, idlog numeric(6,0) NOT NULL, numero numeric(6,0), letra character(1), complemento character varying(20), reside_desde date, idbai numeric(6,0) NOT NULL, idpes_rev numeric, data_rev timestamp without time zone, origem_gravacao character(1) NOT NULL, idpes_cad numeric, data_cad timestamp without time zone NOT NULL, operacao character(1) NOT NULL, bloco character varying(20), andar numeric(2,0), apartamento numeric(6,0), idsis_rev integer, idsis_cad integer NOT NULL, CONSTRAINT ck_endereco_pessoa_operacao CHECK ((((operacao = 'I'::bpchar) OR (operacao = 'A'::bpchar)) OR (operacao = 'E'::bpchar))), CONSTRAINT ck_endereco_pessoa_origem_gravacao CHECK (((((origem_gravacao = 'M'::bpchar) OR (origem_gravacao = 'U'::bpchar)) OR (origem_gravacao = 'C'::bpchar)) OR (origem_gravacao = 'O'::bpchar))), CONSTRAINT ck_endereco_pessoa_tipo CHECK (((tipo >= (1)::numeric) AND (tipo <= (3)::numeric))));

Código antigo – Triggers aleatórias

CREATE FUNCTION fcn_aft_ins_endereco_pessoa() RETURNS trigger LANGUAGE plpgsql AS $$DECLARE v_idpes numeric; v_tipo_endereco text; BEGIN v_idpes := NEW.idpes; v_tipo_endereco := NEW.tipo; EXECUTE 'DELETE FROM cadastro.endereco_externo WHERE idpes='||quote_literal(v_idpes)||' AND tipo='||v_tipo_endereco||';'; RETURN NEW;END; $$;

Código moderno – Framework próprio

~/i/d/i/i/l/CoreExt ls -l master❯❯❯ ⏎

total 140drwxr-xr-x 2 wolverine xmen 4096 Set 25 17:44 Configdrwxr-xr-x 5 wolverine xmen 4096 Ago 6 10:30 Controllerdrwxr-xr-x 2 wolverine xmen 4096 Ago 6 10:30 DataMapperdrwxr-xr-x 2 wolverine xmen 4096 Ago 6 10:30 Entitydrwxr-xr-x 2 wolverine xmen 4096 Ago 6 10:30 Exceptiondrwxr-xr-x 2 wolverine xmen 4096 Ago 6 10:30 Servicedrwxr-xr-x 3 wolverine xmen 4096 Ago 6 10:30 Sessiondrwxr-xr-x 2 wolverine xmen 4096 Ago 6 10:30 Validatedrwxr-xr-x 3 wolverine xmen 4096 Ago 6 10:30 View-rw-r--r-- 1 wolverine xmen 7312 Ago 6 10:30 Config.class.php-rw-r--r-- 1 wolverine xmen 2849 Ago 6 10:30 Configurable.php-rw-r--r-- 1 wolverine xmen 22526 Ago 6 10:30 DataMapper.php-rw-r--r-- 1 wolverine xmen 33495 Ago 6 10:30 Entity.php-rw-r--r-- 1 wolverine xmen 4801 Ago 6 10:30 Enum.php-rw-r--r-- 1 wolverine xmen 1451 Ago 6 10:30 Exception.php-rw-r--r-- 1 wolverine xmen 5437 Ago 6 10:30 Locale.php-rw-r--r-- 1 wolverine xmen 1504 Ago 6 10:30 Session.php-rw-r--r-- 1 wolverine xmen 3205 Ago 6 10:30 Singleton.php-rw-r--r-- 1 wolverine xmen 1486 Ago 6 10:30 View.php

Código moderno – Arquivo de coniguração

[production]app.database.dbname = ieducarapp.database.username = ieducarapp.database.hostname = 10.100.148.56app.database.password = ieducarapp.database.port = 5432

app.aws.bucketname = fotos_alunosapp.aws.awsacesskey = 114aa9bac59642fa951a0fed8359930fc602679dapp.aws.awssecretkey = de53907ec5f10615d1c093bd7eb3d11249381f4f

app.template.vars.instituicao = Secretaria de Educação de Campos Novosapp.template.pdf.titulo = Relatório i-Educarapp.template.pdf.logo = campos_novos.png

app.template.loginpage = templates/template_cidades_digitais.tpl

[gothamcity.ieducar.com.br : production]app.database.dbname = Gothamapp.locale.province = SPapp.entity.name = Prefeitura de Gotham cityreport.logo_file_name = batman.pngapp.routes.redirect_to = /intranet/coringa.php

Código moderno – Bootstrapping

global $coreExt;$coreExt = array();

// Localização para pt_BR$locale = CoreExt_Locale::getInstance();$locale->setCulture('pt_BR')->setLocale();

// Instancia objeto CoreExt_Configuration$coreExt['Config'] = new CoreExt_Config_Ini($configFile, CORE_EXT_CONFIGURATION_ENV);$coreExt['Locale'] = $locale;

// Timezonedate_default_timezone_set($coreExt['Config']->app->locale->timezone);

$tenantEnv = $_SERVER['HTTP_HOST'];

// tenta carregar as configurações da seção especifica do tenant,// ex: ao acessar http://tenant.ieducar.com.br será carregado a seção tenant.ieducar.com.br caso existaif ($coreExt['Config']->hasEnviromentSection($tenantEnv)) $coreExt['Config']->changeEnviroment($tenantEnv);

...

Código moderno – API

class PessoaController extends ApiCoreController { protected function validatesResourceId(); protected function loadPessoa($id = null); protected function loadPessoaByCpf($cpf = null); protected function searchOptions(); protected function get() { $pessoa = array(); if ($this->canGet()) { if ($this->getRequest()->id) $pessoa = $this->loadPessoa($this->getRequest()->id); else $pessoa = $this->loadPessoaByCpf($this->getRequest()->cpf); $attrs = array('id', 'nome'); $pessoa = Portabilis_Array_Utils::filter($pessoa, $attrs); $details = $this->loadDetails($this->getRequest()->id); } return $pessoa; } public function Gerar() { if ($this->isRequestFor('get', 'pessoa-search')) $this->appendResponse($this->search()); elseif ($this->isRequestFor('get', 'pessoa')) $this->appendResponse($this->get()); else $this->notImplementedOperationError(); }}

Código moderno – MVC - View

class ViewController extends Core_Controller_Page_ViewController { protected $_dataMapper = 'Docente_Model_LicenciaturaDataMapper'; protected $_titulo = 'Detalhes da licenciatura'; protected $_processoAp = 635; protected $_tableMap = array( 'Licenciatura' => 'licenciatura', 'Curso' => 'curso', 'Ano de conclusão' => 'anoConclusao', 'IES' => 'ies' ); public function setUrlEditar(CoreExt_Entity $entry) { $this->url_editar = CoreExt_View_Helper_UrlHelper::url( 'edit', array('query' => array( 'id' => $entry->id, 'servidor' => $entry->servidor, 'instituicao' => $this->getRequest()->instituicao )) ); } public function setUrlCancelar(CoreExt_Entity $entry) { $this->url_cancelar = CoreExt_View_Helper_UrlHelper::url( 'index', array('query' => array( 'id' => $entry->id, 'servidor' => $entry->servidor, 'instituicao' => $this->getRequest()->instituicao )) ); }}

Código moderno – MVC - Model

class Docente_Model_Licenciatura extends CoreExt_Entity { protected $_data = array( 'servidor' => NULL, 'licenciatura' => NULL, 'curso' => NULL, 'anoConclusao' => NULL, 'ies' => NULL, 'user' => NULL, 'created_at' => NULL, 'updated_at' => NULL ); protected $_references = array( 'licenciatura' => array( 'value' => NULL, 'class' => 'App_Model_SimNao', 'file' => 'App/Model/SimNao.php' ), 'ies' => array( 'value' => NULL, 'class' => 'Educacenso_Model_IesDataMapper', 'file' => 'Educacenso/Model/IesDataMapper.php' ), 'curso' => array( 'value' => NULL, 'class' => 'Educacenso_Model_CursoSuperiorDataMapper', 'file' => 'Educacenso/Model/CursoSuperiorDataMapper.php' ) );}

Código moderno – Relatórios – Formulários

class BoletimController extends Portabilis_Controller_ReportCoreController { protected $_titulo = 'Boletim Escolar';

function form() { $this->inputsHelper()->dynamic(array('ano', 'instituicao', 'escola', 'curso', 'serie', 'turma')); $this->inputsHelper()->dynamic('matricula', array('required' => false)); $this->inputsHelper()->checkbox('manual', array('label' => 'Preenchimento manual?')); $this->loadResourceAssets($this->getDispatcher()); } function report() {

return new BoletimReport();}

function beforeValidation() { $this->report->addArg('ano', (int)$this->getRequest()->ano); $this->report->addArg('instituicao', (int)$this->getRequest()->ref_cod_instituicao); $this->report->addArg('escola', (int)$this->getRequest()->ref_cod_escola); $this->report->addArg('curso', (int)$this->getRequest()->ref_cod_curso); $this->report->addArg('serie', (int)$this->getRequest()->ref_cod_serie); $this->report->addArg('turma', (int)$this->getRequest()->ref_cod_turma); if (is_null($this->getRequest()->ref_cod_matricula)) $this->report->addArg('matricula',0); else $this->report->addArg('matricula', (int)$this->getRequest()->ref_cod_matricula); $this->report->addArg('manual', $this->getRequest()->manual ? 1 : 0);}}

Código moderno – Relatórios – Mapeamento

class BoletimReport extends Portabilis_Report_ReportCore { function templateName() { $flagTipoBoletimTurma = App_Model_IedFinder::getTurma($codTurma = $this->args['turma']); $flagTipoBoletimTurma = $flagTipoBoletimTurma['tipo_boletim']; if (empty($flagTipoBoletimTurma)) { throw new Exception( Portabilis_String_Utils::toLatin1("NÃ£o foi definido o tipo de boletim no cadastro de turmas.") ); } $tiposBoletim = Portabilis_Model_Report_TipoBoletim; $templates = array($tiposBoletim::BIMESTRAL => 'portabilis_boletim', $tiposBoletim::TRIMESTRAL => 'portabilis_boletim_trimestral'); $template = is_null($flagTipoBoletimTurma) ? '' : $templates[$flagTipoBoletimTurma];

function requiredArgs() {$this->addRequiredArg('ano');$this->addRequiredArg('instituicao');$this->addRequiredArg('escola');$this->addRequiredArg('curso');$this->addRequiredArg('serie');$this->addRequiredArg('turma');

}}

Código moderno – Relatórios – .jrxml

<?xml version="1.0" encoding="UTF-8"?><jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" name="portabilis_boletim" language="groovy" pageWidth="595" pageHeight="842" columnWidth="555" leftMargin="20" rightMargin="20" topMargin="20" bottomMargin="20" uuid="4f9ea369-c6c3-48c5-ae82-2872022857d3">

<parameter name="ano" class="java.lang.Integer"><defaultValueExpression><![CDATA[new

java.lang.Integer(0)]]></defaultValueExpression></parameter><parameter name="instituicao" class="java.lang.Integer">

<defaultValueExpression><![CDATA[new java.lang.Integer(0)]]></defaultValueExpression>

</parameter><parameter name="escola" class="java.lang.Integer">


</parameter><parameter name="curso" class="java.lang.Integer">


</parameter><parameter name="serie" class="java.lang.Integer">


</parameter>

Futuro para o código

● Premissa: Aprender com o passado

● Merging nos repositórios do SPB

● Migrations: Phinx

● Concluir implementação da API

● Padronizar uma API

● Criar novos clientes – Professor, Gestão, Pais

● Refatorar o backend

Trabalho em Comunidade

Novos documentos e relatórios

Diário de classe

Certificado de conclusão

Atestado de reserva de vaga

...

Administração no atendimento multi-tenant

Múltiplos clientes por

instância de aplicação

Facilidade de administração

Melhorias no acesso ao PostgreSQL

Migração da versão 8.2 para 9.x

Visualização dos dados do coletor de estatísticas

Automação de testes com Behat + Mink

BDD: Behavior-Driven Development

Próximo passo: Integração contínua

Integração com Educacenso

Importação dos dados do Censo Escolar/INEP

Migração completa em desenvolvimento na comunidade

Próximos passos

Conclusão dos rollouts atuais

- Cidades Digitais

- Valparaíso de Goiás

Entrega do modelo de negócio/serviço

Novas funcionalidades e melhoria contínua

"Fazer do SERPRO uma empresa atuante,

parceira e inovadora em soluções de

gestão educacional, escolar e acadêmica

para uma Pátria, de fato, Educadora."

"O SERPRO, em atendimento ao Programa Cidades Digitais,

internalizou o i-Educar e agora implanta uma nova linha de

atuação para atendimento educacional, com

desenvolvimento colaborativo em comunidade."

Carlos M. dos Santos

Desenvolvedor de Software

SERPRO Florianópolis

[email protected]

+55 48 3231 8970

i-Educar - 1º Seminário PHP no Serpro

Technology