Skip to content

thglex/neom

Repository files navigation

NEOM NETWORKS - Management System

Sistema de gerenciamento de OLTs multivendor (Nokia, Huawei, Fiberhome, Datacom, ZTE) baseado em Laravel e Python, otimizado para Docker.

🚀 Estrutura do Projeto

Para manter a organização do deploy, o projeto segue esta estrutura:

  • / (Raiz): Configurações de infraestrutura (Docker, Git, .env).
  • /AppDATA: Código-fonte da aplicação (Laravel, Scripts Python).
  • /docs: Documentação técnica detalhada e diagramas.

📘 Documentação por Módulo

Acesse os guias técnicos específicos para entender fluxos de rede e orquestração:


🛠️ Como Instalar e Rodar (Deploy)

Siga os passos abaixo para subir o ambiente:

1. Clonar o Repositório

git clone https://github.com/thglex/neom.git
cd neom

2. Configurar Variáveis de Ambiente

Crie o arquivo .env na raiz do projeto e ajuste as credenciais do banco:

cp .env.example .env

3. Subir os Containers

Execute o comando para construir e iniciar os serviços:

docker compose up -d --build

Nota: O container da aplicação aguardará automaticamente o banco de dados estar pronto (Healthcheck) antes de iniciar.

4. Instalar Dependências e Migrar Banco

Na primeira execução, instale as dependências e popule o banco:

# Instalar dependências (Composer)
docker exec neom-app composer install

# Gerar chave da aplicação
docker exec neom-app php artisan key:generate --show
# > Copie o código gerado e cole no seu .env na linha APP_KEY=.

# Rodar migrações e popular banco (Seed)
docker exec neom-app php artisan migrate --seed

🐳 Comandos de Manutenção

  • Ver Logs: docker logs -f neom-app
  • Reiniciar Sistema: docker compose restart
  • Acessar Terminal do App: docker exec -it neom-app bash
  • Permissões: O sistema corrige permissões no boot. Caso precise forçar: docker exec -u root neom-app chown -R www-data:www-data storage bootstrap/cache

📝 Créditos e Licença

Licença deste projeto: Todos os direitos reservados. Uso privado / restrito.

Este projeto é baseado no código do repositório https://github.com/ErnestoMuniz/neom, mas não é um fork oficial nem mantém relação direta com o autor original.

O código-fonte original não inclui um arquivo de licença explícita (além da licença MIT que se aplica apenas ao framework Laravel). Portanto, aplica-se a proteção padrão de copyright:

© 2025-2026 Thiago Alex (baseado em obra de Ernesto Muniz). Todos os direitos reservados.

Não é permitida a cópia, modificação, distribuição, uso comercial ou republicação (total ou parcial) sem autorização expressa por escrito do mantenedor.

Se você deseja utilizar partes deste projeto em algo público ou comercial, entre em contato comigo.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published