Important
Este repositório é um mirror de DBSeller/e-cidade,
mantido por DBSeller.
A organização e-Cidade sincroniza este repositório para facilitar a descoberta das diferentes linhas de desenvolvimento do projeto. A presença deste mirror não transfere a autoria ou a manutenção do código para a organização e-Cidade e não indica que esta distribuição seja oficial ou preferencial.
Para alterações no código proveniente do upstream, contribua diretamente em
DBSeller/e-cidade.
O e-Cidade é um sistema integrado desenvolvido para a gestão municipal. Ele atende as áreas financeira, patrimonial, tributária, de recursos humanos, de educação e de saúde. A ferramenta é destinada ao uso diário por servidores públicos do município e também pelos cidadãos. Seu principal objetivo é automatizar, agilizar e simplificar os processos da administração pública, promovendo uma gestão mais transparente, eficiente e que melhore o atendimento à população.
Este projeto é considerado legado e utiliza as seguintes tecnologias fundamentais:
- Backend: PHP 5.6
- Frontend: HTML e Javascript
- Banco de Dados: PostgreSQL
- Servidor Web: Apache ou Nginx
⚠️ Atenção: Devido aos requisitos legados (como o PHP 5.6), o uso do Docker é o ambiente de desenvolvimento fortemente recomendado. A instalação manual convencional encontra-se atualmente em construção.
O e-Cidade trabalha com um modelo de repositório oficial e um repositório espelho para facilitar as contribuições:
- Repositório Oficial (Portal do Software Público Brasileiro): Localizado em http://softwarepublico.gov.br/gitlab/e-cidade/. Este é o ambiente institucional de referência, servindo sempre como a fonte oficial onde são mantidas as versões do projeto.
- Repositório Espelho (GitHub): Disponibilizado em https://github.com/DBSeller/e-cidade, com o apoio e manutenção da DBSeller Serviços de Informática Ltda. Ele funciona como um ambiente colaborativo adicional que permite maior interação da comunidade e facilita o envio de contribuições via issues e pull requests.
- Sincronização: Todo o código-fonte enviado e mantido no GitHub é refletido e incorporado no repositório oficial.
O projeto está configurado em containers para simplificar ao máximo sua execução e isolar o ambiente.
Pré-requisitos: Certifique-se de ter instalado o Docker e o Docker Compose.
-
Clonar o projeto: Baixe o repositório oficial em sua máquina e acesse a pasta gerada:
git clone http://softwarepublico.gov.br/gitlab/e-cidade/e-cidade.git cd e-cidade -
Subir os containers: A partir do diretório raiz do e-Cidade, construa e inicie os serviços executando o comando abaixo:
docker-compose up -d --build
Nota: Todos os containers possuem um volume mapeado da raiz do e-Cidade diretamente para a pasta
/var/www/html/de cada container respectivo. -
Descompactar o banco de dados:
docker exec -it ecidade_php56 gunzip docker/ecidade_base.sql.gz -
Executar o Script de Instalação: Rode o script de instalação por dentro do container PHP:
docker exec -it ecidade_php56 bash docker/install.sh -
Ajustar permissões do sistema: Na raiz do e-Cidade, aplique as permissões adequadas na pasta para garantir o funcionamento correto:
docker exec -it ecidade_php56 chmod -R 775 /var/www/html -
Acessar a Aplicação: Após finalizar, o sistema estará pronto para acesso através do navegador nos seguintes endereços:
Credenciais Padrão de Acesso:
- Login:
dbseller - Senha:
dbseller
- Login:
- A porta 8080 já está em uso? Altere o arquivo
docker-compose.yml, mudando a configuração de8080:80para outra porta disponível (ex:8081:80) e acesse através de http://localhost:8081. - O script
install.shnão foi encontrado? Verifique se o seu terminal está no diretório correto (raiz do projeto) e se o arquivo reside no caminhodocker/install.sh. - Ocorreu erro de permissão no script? Você pode conceder a permissão de execução usando o comando:
chmod +x docker/install.sh. - Deseja reinstalar (refazer o sistema e o banco)? Remova tudo (volumes e imagens) com o comando
docker-compose down -v --rmi alle, após isso, repita os passos 4 e 5 da instalação.
A arquitetura das imagens no Docker funciona com o seguinte roteamento:
+----------+
| browser |
+----------+
| |
| |
+----------------+
| localhost:8080 |
+----------------+
| |
| |
+----------------+
| ecidade-apache |
+----------------+
| |
| |
____| |_____
/ \
/ \
+------------------------------------+
| POSTGRES 5432 |
+------------------------------------+
A evolução contínua da ferramenta depende da comunidade, e contribuições são muito bem-vindas! Para contribuir, sugerimos utilizar o repositório espelho no GitHub seguindo este fluxo:
- Acesse o GitHub e clique em Fork no projeto.
- Crie uma nova branch para o seu desenvolvimento:
git checkout -b minha-feature
- Implemente as correções ou melhorias necessárias.
- Realize o commit descrevendo a sua alteração:
git commit -m "feat: descrição da alteração" - Envie o código para o seu repositório (fork):
git push origin minha-feature
- Acesse a página do repositório original e clique em Compare & Pull Request, fornecendo uma descrição clara da sua modificação.
- Grupo Oficial do Telegram: Para comunicação direta, alinhamentos da comunidade, suporte e dúvidas, participe do canal através do link https://t.me/eCidadeCE.
- Registro de Problemas (Issues): Para demandas técnicas específicas ou bugs, recomenda-se registrar uma Issue nos repositórios, a fim de manter a rastreabilidade do problema sempre que possível.