Lançando o maior software livre educacional do Brasil!
Clone or download
Latest commit 8eb786e Nov 30, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update PULL_REQUEST_TEMPLATE.md Oct 24, 2018
app Merge branch 'master' into issue-4559 Nov 30, 2018
bootstrap Adiciona arquivo de bootstrap para testing Nov 22, 2018
config Remove nome proprietário Nov 27, 2018
database Remove a migration do nome social e adiciona a seed Nov 26, 2018
docker Aumenta o timeout do Composer Nov 30, 2018
ieducar Merge branch 'master' into laravel Nov 30, 2018
public Lida com a versão do PHP de forma dinâmica Nov 30, 2018
resources Laravel 5.7 Nov 16, 2018
routes Remove rotas não utilizadas Nov 2, 2018
scripts Compilação dos relatórios na hora do build Nov 30, 2018
src Lida com a versão do PHP de forma dinâmica Nov 30, 2018
storage Laravel 5.7 Nov 16, 2018
tests Pula o teste da API Nov 30, 2018
.editorconfig Atualiza o EditorConfig Sep 5, 2018
.env.example Desativa Telescope por padrão Nov 30, 2018
.gitignore Merge branch 'master' into issue-4559 Nov 30, 2018
.php_cs Implementa code-sniffer com FriendsOfPHP/PHP-CS-Fixer Jun 17, 2018
.scrutinizer.yml Scrutinizer Nov 30, 2018
.travis.yml Revert "Remove testes no PHP 7.1" Nov 30, 2018
artisan Laravel Sep 5, 2018
code-of-conduct.md Renomeia arquivos Sep 5, 2018
composer.json Diminui a dependência do PHP Nov 30, 2018
composer.lock Diminui a dependência do PHP Nov 30, 2018
contributing.md Renomeia arquivos Sep 5, 2018
docker-compose.yml Renomeia os containers Nov 30, 2018
license Renomeia arquivos Sep 5, 2018
package.json Laravel 5.7 Nov 16, 2018
phpunit.dusk.xml Laravel Dusk Sep 5, 2018
phpunit.xml Usa configurações do arquivo .env.testing Nov 22, 2018
readme.md Atualiza readme com correção da versão do PHP Nov 30, 2018
server.php Laravel Sep 5, 2018
webpack.mix.js Laravel 5.7 Nov 16, 2018

readme.md

Latest Release Coverage Status

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!

Conteúdo

  1. Sobre o i-Educar
  2. Comunicação
  3. Roadmap de tecnologia
  4. Como contribuir
  5. Instalação
  6. FAQ

Sobre i-Educar

O i-Educar é um software livre de gestão escolar totalmente on-line que permite secretários escolares, professores, coordenadores e gestores da área possam utilizar uma ferramenta que produz informações e estatísticas em tempo real, com um banco de dados centralizado e de fácil acesso, diminuindo a necessidade de uso de papel, a duplicidade de documentos, o tempo de atendimento ao cidadão e racionalizando o trabalho do servidor público.

Ele foi originalmente desenvolvido pela prefeitura de Itajaí - SC e disponibilizado no Portal do Software Público do Governo Federal em 2008, com o objetivo de atender às necessidades das Secretarias de Educação e Escolas Públicas de todo o Brasil.

Comunicação

Acreditamos que o sucesso do projeto depende diretamente da interação clara e objetiva entre os membros da Comunidade. Por isso, estamos definindo algumas políticas para que estas interações nos ajudem a crescer juntos! Você pode consultar algumas destas boas práticas em nosso código de conduta.

Além disso, gostamos de meios de comunicação assíncrona, onde não há necessidade de respostas em tempo real. Isso facilita a produtividade individual dos colaboradores do projeto.

Canal de comunicação Objetivos
Fórum - Tirar dúvidas
- Discussões de como instalar a plataforma
- Discussões de como usar funcionalidades
- Suporte entre membros de comunidade
- FAQ da comunidade (sobre o produto e funcionalidades)
Issues do Github - Sugestão de novas funcionalidades
- Reportar bugs
- Discussões técnicas
Telegram - Comunicar novidades sobre o projeto
- Movimentar a comunidade
- Falar tópicos que não demandem discussões profundas

Qualquer outro grupo de discussão não é reconhecido oficialmente pela comunidade i-Educar e não terá suporte da Portabilis - mantenedora do projeto.

Roadmap de tecnologia

O i-Educar por ser um sistema antigo e por não ter seguido um padrão específico, precisa passar por um processo de melhoria para diminuir a quantidade de bugs, melhorar a manutenibilidade e enfim permitir a evolução através de features.

Passos iniciais

  • Adoção do PSR1
  • Adoção do PSR2
  • Adoção do PSR4
  • Iniciar a cobertura de testes para possibilitar refatorações

Planejamento Técnico

Em nossa wiki você encontra um planejamento mais técnico de como devemos prosseguir com as melhorias e evoluções do nosso projeto. Clique aqui para ler mais a respeito.

Como contribuir

Contribuições são super bem vindas! Se você tem vontade de construir o i-Educar junto conosco, veja o nosso guia de contribuição onde explicamos detalhadamente como trabalhamos e de que formas você pode nos ajudar a alcançar nossos objetivos.

Instalação

Depêndencias

Para executar o projeto é necessário a utilização de alguns softwares para facilitar o desenvolvimento.

Nova instalação

ATENÇÃO: Essa forma de instação tem o objetivo de facilitar demonstrações e desenvolvimento. Não é recomendado para ambientes de produção!

Para instalar o projeto execute todos os passos abaixo, caso você deseje atualizar sua instalação do i-Educar, siga os passos do upgrade.

Clone o repositório:

git clone https://github.com/portabilis/i-educar.git && cd i-educar

Faça o build das imagens Docker utilizadas no projeto (pode levar alguns minutos) e inicie os containers da aplicação:

docker-compose up -d --build

Execute o comando para fazer uma nova instalação:

docker-compose exec php composer new-install

Primeiro acesso

Após finalizada a instalação, descubra em qual endereço o i-Educar está rodando, basta executar o comando:

docker-compose port nginx 80

Acesse o endereço que será exibido após rodar o comando acima.

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.

Personalizando a instalação

Você pode criar um arquivo docker-compose.override.yml para personalizar sua instalação do i-Educar, mudando as portas dos serviços ou o mapeamento dos volumes extras para a aplicação.

Xdebug

A ferramenta Xdebug está incluída no projeto com o intuito de facilitar o processo de debug durante o desenvolvimento. Para configurá-la, modifique os valores das variáveis XDEBUG_* no arquivo docker-compose.override.yml conforme orientações da sua IDE de desenvolvimento.

Executando testes unitários

Para rodar os testes, é necessário ter o i-Educar rodando e com uma base limpa, apenas a estrutura inicial e as migrations, crie o arquivo de configuração:

cp .env.example .env.testing

Execute o comando:

docker-compose exec php vendor/bin/phpunit

Instalação em servidor

O i-Educar possui um instalador que pode te auxiliar no processo de instalação em um servidor para produção.

Antes de tudo faça download da versão mais recente do i-Educar e extraia o conteúdo do release em uma pasta no seu servidor. O instalador está disponível desde a versão 2.1.0.

Requerimentos

Para executar o i-Educar em um servidor você precisa dos seguintes programas:

Você precisa das seguintes extensões para PHP:

  • bcmath
  • curl
  • dom
  • fileinfo
  • json
  • libxml
  • mbstring
  • openssl
  • PDO
  • pgsql
  • Phar
  • SimpleXML
  • tokenizer
  • xml
  • xmlwriter
  • zip
  • pcre

O instalador do i-Educar te avisa caso alguma extensão esteja faltando então não se preocupe em instalar tudo agora.

Configurando o servidor

O Nginx precisa estar devidamente configurado para rodar o i-Educar e permitir acesso ao instalador. Você encontra um exemplo de configuração aqui.

Em sistemas Ubuntu, por exemplo, você colocaria este arquivo na pasta /etc/nginx/sites-available e criaria um symlink para ele na pasta /etc/nginx/sites-enabled.

Não esqueça de adequar a configuração de acordo com a realidade do seu servidor principalmente as seguintes diretivas:

  • root
  • fastcgi_pass

Depois de tudo pronto basta reiniciar o processo do nginx para que as configurações novas entrem em vigor.

Executando o instalador

Agora que o Nginx está configurado você pode acessar o instalador em:

http://www.example.com/install.php

Substitua "www.example.com" pelo seu domínio ou endereço de IP. A partir daqui o instalador deverá te dar todas as instruções necessárias para realizar a instalação com sucesso. Todo exemplo de comando ou código que possa vir a aparecer no processo de instalação leva em consideração o seu ambiente, ou seja, fique à vontade para copiar e colar os comandos que eles deverão funcionar corretamente.

Quando tudo estiver ok você poderá definir uma senha para o usuário admin e iniciar o processo de instalação. Se tudo correr bem você poderá acessar o i-Educar normalmente.

Em caso de erros no processo de instalação verifique os logs do sistema que se encontram em storage/logs para determinar suas causas. Não hesite em entrar em contato caso enfrente dificuldades!

Upgrade para 2.1

Para fazer o upgrade da versão 2.0 para a 2.1 do i-Educar, você precisará executar os seguintes passos:

git fetch
git checkout 2.0.11

git -C ieducar/modules/Reports fetch
git checkout 2.0.0

docker-compose exec ieducar_1604 ieducar/vendor/bin/phinx migrate

Após este passo, você precisará fazer o backup do seu banco de dados para restaurá-lo após a atualização do seu código fonte.

docker-compose down

git checkout master
git pull
rm -rf ieducar/vendor
git checkout ieducar/vendor

git -C ieducar/modules/Reports checkout master
git -C ieducar/modules/Reports pull

docker-compose build
docker-compose up -d
docker-compose exec php composer update-install

Sua instalação estará atualizada e você poderá realizar seu primeiro acesso na nova versão do i-Educar.

Perguntas frequentes (FAQ)

Algumas perguntas aparecem recorrentemente. Olhe primeiro por aqui: FAQ


Powered by Portabilis Tecnologia