View on GitHub

📺 TV Corporativa & Sinalização Digital

Sistema moderno para gestão de TVs corporativas, painéis informativos, totens verticais e chamada de senhas.

📺 TV Corporativa & Sinalização Digital (Digital Signage v2.0)

Sistema moderno, robusto e de alto desempenho para gestão de TVs corporativas, painéis informativos, totens verticais e chamadas de senhas em consultórios/recepções.

Node.js TypeScript Docker Tests License: MIT


📸 Demonstração Visual do Sistema

🖥️ Painel Administrativo CMS

📊 Dashboard & Monitoramento em Tempo Real

Métricas operacionais em tempo real, status de conexão das TVs cadastradas e chamada de senhas no consultório.

Dashboard & Monitoramento

🖥️ Gestão de Telas & Displays

Configuração de pontos de exibição (TV-01, TV-02 e Totens Verticais), resoluções (16:9 e 9:16) e vinculação de playlists.

Gerenciar Telas & Displays

📁 Biblioteca Central de Mídias

Upload instantâneo por arrastar-e-soltar ou colar (Ctrl+V), definição de tempos de exibição e galeria organizada.

Biblioteca de Mídias

📐 Arquitetura de Layouts Multi-Zonas

Pré-configurações para Recepção, Totens Verticais de elevador, Grid 2x2 e Chamada de Senhas com áudio nativo.

Layouts Multi-Zonas


📺 Player em Tempo Real nas TVs

🎬 Player ao Vivo — TV Recepção Principal (16:9)

Layout Notícias & TV: Vídeo 70%, Sidebar lateral direita com relógio digital, previsão do tempo ao vivo e comunicado oficial da Polícia Federal.

Player ao Vivo Recepção

📰 Exibição de Slides com Ticker Contínuo de Notícias RSS

Transição suave em aceleração de hardware via GPU e rodapé dinâmico com manchetes de notícias RSS em tempo real.

Exibição de Slides com Feed de Notícias RSS


🌟 Principais Recursos e Diferenciais


👥 Usuários Padrão Iniciais

O sistema já é inicializado com dois usuários pré-configurados:

Usuário Senha Padrão Perfil Permissões
admin tvcorporativa Administrador Geral Acesso irrestrito a todas as funções e telas
edkallenn 123456 Administrador / Gestor Gestão de telas, uploads de mídia, layouts e senhas

📺 Telas Padrão Pré-Configuradas

Ao inicializar, o sistema já disponibiliza 3 telas prontas para visualização imediata:

  1. TV-01 (Recepção Principal): Layout Corporativo com Vídeo, Sidebar com Clima/Hora e Rodapé RSS.
    🔗 http://localhost:8080/player?code=TV-01
  2. TV-02 (Consultório / Sala de Espera): Layout com Painel de Chamada de Senhas e Mídia.
    🔗 http://localhost:8080/player?code=TV-02
  3. TV-03 (Totem Vertical Elevador): Layout Retrato 9:16 com Clima no Topo, Vídeo Central e Notícias na Base.
    🔗 http://localhost:8080/player?code=TV-03

🔀 Versão Alternativa em Go (Golang)

💡 Nota Arquitetural: Conforme especificado no planejamento, uma versão alternativa completa implementada em Go (Golang) de altíssimo desempenho (< 25MB RAM, binário estático compilado) está disponível na branch feature/go-alternative deste repositório. Para alternar e inspecionar a versão em Go:

git checkout feature/go-alternative

🚀 Como Executar o Sistema

Opção 1: Execução com Docker (Recomendado para Produção)

Basta clonar o projeto e executar um único comando:

# Subir o ambiente completo conteinerizado
docker compose up -d

O serviço iniciará na porta 8080:

Para parar os containers:

docker compose down

Opção 2: Execução Local (Node.js)

Se desejar executar nativamente na sua máquina:

# 1. Instalar dependências
npm install

# 2. Executar em modo de desenvolvimento (Live Reload)
npm run dev

# Ou compilar e rodar a versão de produção:
npm run build
npm start

Opção 3: Execução em Go (feature/go-alternative)

O projeto também conta com um motor backend completo em Go (Golang 1.22+) na branch feature/go-alternative, com 100% de paridade de funcionalidades (v1.3.1), compartilhando o mesmo banco SQLite (data/tv_corporativa.db) e a mesma pasta de mídias (media/), consumindo apenas ~15 MB de RAM:

# 1. Alternar para a branch em Go
git checkout feature/go-alternative

Via Docker (Recomendado — não requer Go instalado na máquina):

docker compose -f docker-compose.go.yml up -d --build

Ou nativamente com Go instalado (Windows / Linux / macOS):

# No Windows (PowerShell com GCC do MSYS2/MinGW no PATH para o SQLite CGO):
$env:Path += ";C:\msys64\ucrt64\bin"
$env:CGO_ENABLED = "1"
go mod tidy
go run ./cmd/server/main.go

# Ou gerar um executável nativo (.exe):
go build -ldflags="-s -w" -o tv-corporativa.exe ./cmd/server
.\tv-corporativa.exe
# No Linux / macOS:
CGO_ENABLED=1 go mod tidy
CGO_ENABLED=1 go run ./cmd/server/main.go

🧪 Testes Automatizados

O sistema conta com suíte abrangente de testes de integração cobrindo autenticação, telas, layouts multi-zonas, widgets e chamada de senhas:

npm test

Resultado dos testes:

PASS tests/widgets.test.ts
PASS tests/layouts.test.ts
PASS tests/displays.test.ts
PASS tests/queue.test.ts
PASS tests/auth.test.ts

Test Suites: 5 passed, 5 total
Tests:       16 passed, 16 total
Snapshots:   0 total
Time:        6.3 s

📁 Estrutura de Diretórios

tv-corporativa/
├── data/                   # Volume persistente do banco SQLite (tv_corporativa.db)
├── media/                  # Volume persistente de vídeos e imagens enviados
├── public/                 # Front-end da aplicação
│   ├── css/
│   │   ├── admin.css       # Estilos do painel de controle CMS
│   │   └── player.css      # Estilos acelerados por GPU do reprodutor da TV
│   ├── js/
│   │   ├── admin.js        # Lógica SPA do CMS administrativo
│   │   └── player.js       # Motor do player (Multi-Zone, Vídeo, WebSockets, Áudio)
│   ├── index.html          # Interface do Painel Administrativo
│   ├── player.html         # Interface da TV Player
│   └── sw.js               # Service Worker para suporte offline
├── src/                    # Código-fonte TypeScript do Backend
│   ├── config/             # Variáveis de ambiente e caminhos
│   ├── database/           # Conexão SQLite (WAL mode), migrações e seed inicial
│   ├── middleware/         # Autenticação JWT e upload com Multer
│   ├── routes/             # Endpoints REST (Auth, Displays, Layouts, Media, Queue, Widgets)
│   ├── services/           # Hub WebSockets e parser RSS com cache
│   ├── app.ts              # Configuração da aplicação Express
│   └── server.ts           # Ponto de entrada (Bootstrap HTTP + WS)
├── tests/                  # Testes automatizados (Jest / Supertest)
├── Dockerfile              # Imagem Docker multi-stage otimizada
├── docker-compose.yml      # Orquestração com volumes persistentes
├── package.json            # Dependências e scripts
└── tsconfig.json           # Configurações do compilador TypeScript

📄 Licença

Distribuído sob a licença MIT. Livre para uso comercial e corporativo.


☕ Apoie o Projeto (Me Pague um Café / Buy Me a Coffee)

Este projeto é desenvolvido com dedicação e carinho. Se este projeto foi útil para os seus estudos, trabalho ou produtividade diária e você quiser apoiar o desenvolvimento contínuo:

Buy Me a Coffee QR Code — Edkallenn (@ed1rac)

Muito obrigado pelo apoio! 🚀