README.md
i-Educar
“Lançando o maior software livre educacional do Brasil!”.
Nós somos a Comunidade i-Educar e acreditamos que podemos transformar o nosso país por meio da educação. Junte-se a nós!
O i-Educar é um software livre e público totalmente on-line que torna mais fácil e prática a gestão dos processos das escolas, matrículas e dados de alunos, apoiando os profissionais da rede de ensino e gestores a resolverem os desafios da educação dentro e fora da sala de aula.
Conteúdo
- Cenário atual
- Sobre o i-Educar
- Instalação
- Solicite demonstração do software
- Solicite prestação de serviço
Cenário atual
No final de 2017, a Portabilis, organização que é integrante da comunidade desde 2009 e tem o papel de mantenedora do projeto, propôs uma renovação de energias para levar o i-Educar ainda mais longe. (Leia aqui o manifesto: i-Educar por todo o Brasil).
No sentido desta iniciativa, está a proposta de acabar com a defasagem da versão aberta e aumentar a aproximação com os seus usuários. No dia 31 de janeiro, a Portabilis anunciou o apoio da Fundação Lemann para potencializar todos esses objetivos (Saiba mais aqui: Preparação do lançamento do maior software livre educacional do Brasil!).
Etapas iniciais deste processo
- Liberar na versão Comunidade as principais melhorias feitas pela Portabilis nos últimos anos;
- A Portabilis irá mudar seu fluxo de trabalho passando a desenvolver diretamente no repositório da Comunidade;
- Planejar tecnicamente o projeto, com foco em refatoração e criação de padrões, para possibilitar o crescimento e expansão do uso do i-Educar;
- Iniciar as refatorações propostas na fase de planejamento permitindo contribuições de forma mais ativa;
- Evoluir constantemente o i-Educar com ênfase nos usuários e na facilidade do uso em redes públicas de ensino.
Sobre o i-Educar
O i-Educar é um software livre e público para a gestão escolar que foi desenvolvido originalmente pela Prefeitura de Itajaí-SC e disponibilizado como Software Livre no Portal do Software Público Brasileiro (https://softwarepublico.gov.br), onde atualmente é mantido pela Comunidade i-Educar.
Instalação
Antes de começar você vai precisar instalar o Docker e o Docker Compose em sua máquina. Para mais informações veja estes links:
- Docker (> 18.03.1-ce)
- Docker Compose (> 1.21.2)
Você também vai precisar do Git caso ainda não o tenha instalado.
Depois de ter o Docker e git instalados faça o clone deste repositório e execute o Docker Compose para criar os containers da aplicação:
$ git clone https://github.com/portabilis/i-educar.git i-educar
$ cd i-educar
$ docker-compose up -d
Depois disto faça uma cópia do arquivo ieducar/configuration/ieducar.ini.sample
para ieducar/configuration/ieducar.ini realizando as alterações necessárias.
Instalando relatórios
Os relatórios respondem por uma parte muito importante no i-Educar mas o desenvolvimento destes relatórios ocorre de forma paralela em outro repositório. Por isso, antes de prosseguir, é necessário "instalar" os relatórios em conjunto com o i-Educar. Execute o seguinte comando a partir da pasta onde o i-Educar foi clonado em sua máquina:
$ git clone https://github.com/portabilis/i-educar-reports-package.git ieducar/modules/Reports
Instalando outras dependências
O i-Educar usa o Composer para gerenciar suas dependências. O Composer já vem pré-instalado na imagem via Docker então para instalar as dependências use os seguintes comandos:
$ docker-compose exec ieducar_1604 composer install
Inicializando o banco de dados
O próximo passo é inicializar o banco de dados do i-Educar. Nós utilizamos o Phinx para executar migrações e preencher os dados em nosso banco. O Phinx já é instalado como dependência através do Composer no passo anterior, mas é necessário configurá-lo antes de executar qualquer comando.
Na raiz do projeto você encontra um arquivo chamado phinx.php.sample. Copie
este arquivo e altere seu nome para phinx.php. Verifique seu conteúdo e,
caso tenha feito alguma mudança na configuração do Docker, modifique as
credenciais do banco de acordo com suas alterações. Caso contrário o arquivo
estará pronto para ser utilizado.
Atenção:
Se quiser rodar o Phinx a partir de sua própria máquina, fora de um container,
modifique a chave host para localhost e port para 5434.
Depois de ter feito a configuração do Phinx, basta rodar os seguintes comandos:
$ docker-compose exec ieducar_1604 ieducar/vendor/bin/phinx seed:run -s StartingSeed -s StartingForeignKeysSeed
$ docker-compose exec ieducar_1604 ieducar/vendor/bin/phinx migrate
Este comando irá executar a criação de tabelas e inserção de dados iniciais para utilização do i-Educar.
Configurando permissões
Para que tudo funcione adequadamente, principalmente a parte de relatórios, é necessário definir algumas permissões especiais em pastas e arquivos. Use os comandos abaixo:
$ docker-compose exec ieducar_1604 chmod +x ieducar/vendor/portabilis/jasperphp/src/JasperStarter/bin/jasperstarter
$ docker-compose exec ieducar_1604 chmod 777 -R ieducar/modules/Reports/ReportSources/Portabilis
Primeiro acesso
Após realizar a instalação de acordo com as instruções acima você está pronta a realizar seu primeiro acesso ao i-Educar. Basta acessar o seguinte endereço:
O usuário padrão é: admin / A senha padrão é: 123456789
Assim que realizar seu primeiro acesso não se esqueça de alterar a senha padrão.
Solicite demonstração do software
Para solicitar uma demonstração, nos envie uma mensagem ou nos ligue por meio da nossa página de contato.
Solicite prestação de serviço
Para solicitar serviço de migração de dados, instalação, atualização, correções ou desenvolvimento de alterações, entre em contato por meio da nossa página de contato.