O portal NCCSoft's é a central de acesso unificado para aplicações internas da empresa. Combina autenticação SSO via Google OAuth2, gestão de permissões granulares por aplicativo e uma interface de administração completa.

Infraestrutura

• Servidor: Contabo VPS, Ubuntu LTS
• Proxy reverso: Nginx com SSL via Let's Encrypt (certbot)
• Servidor de aplicação: Gunicorn (WSGI) rodando na porta 8000
• Banco de dados: PostgreSQL — banco nccsofts, usuário nccsofts_user
• Gerenciamento de processos: systemd (serviço bluedeploy)

Links

• Portal: https://www.nccsofts.com.br
• Documentação: https://docs.nccsofts.com.br
• BlueDeploy: https://bluedeploy.nccsofts.com.br
• Monitor Jurídico: https://monitorjuridico.nccsofts.com.br
• Repositório: NccSofts/Blue-Service no GitHub

Internet
  └── Nginx (reverse proxy)
        ├── www.nccsofts.com.br   → /var/www/nccsofts (HTML estático)
        │     └── /sso/*          → BlueDeploy (Gunicorn :8000)
        ├── docs.nccsofts.com.br  → /var/www/nccsofts-docs (HTML estático)
        │     └── /sso/api/me     → proxy para BlueDeploy
        ├── bluedeploy.nccsofts.com.br → BlueDeploy (Gunicorn :8000)
        └── monitorjuridico.nccsofts.com.br → Monitor Jurídico (unix socket)

Stack Tecnológico

• Linguagem: Python 3
• Framework: Flask
• ORM: SQLAlchemy
• Banco de dados: PostgreSQL
• OAuth2: Authlib (Google OAuth2)
• Servidor WSGI: Gunicorn
• Proxy reverso: Nginx
• SSL: Let's Encrypt (certbot)

O SSO é implementado via Google OAuth2 usando a biblioteca Authlib. O cookie de sessão é compartilhado entre todos os subdomínios .nccsofts.com.br.

Mecanismo

Google OAuth2 via Authlib. Configurado com SESSION_COOKIE_DOMAIN = .nccsofts.com.br para que o cookie seja válido em todos os subdomínios.

Fluxo de Autenticação

Decorators Disponíveis

• @sso_required — exige sessão SSO (session["sso_email"])
• @admin_required — exige sessão SSO + session["sso_is_admin"] = True

Modelos de Banco

• sso_users — id, email, nome, foto_url, ativo, is_admin, criado_em, ultimo_acesso
• sso_apps — id, slug, nome, url_base, ativo, icone
• sso_permissoes — id, user_id, app_id, concedido_em — constraint única (user_id, app_id)

Rotas SSO

• Localização no servidor: /opt/bluedeploy/
• Entry point: BlueDeploy/app_bluedeploy.py → bluedeploy_app.app.create_app()
• Serviço systemd: bluedeploy (Gunicorn na porta 8000)
• Banco de dados: PostgreSQL, banco nccsofts, usuário nccsofts_user

Variáveis de Ambiente Obrigatórias

• NCC_DATABASE_URL ou DATABASE_URL — DSN PostgreSQL
• GOOGLE_CLIENT_ID — ID do cliente OAuth Google
• GOOGLE_CLIENT_SECRET — Segredo do cliente OAuth Google
• GOOGLE_REDIRECT_URI — URI de callback OAuth
• SECRET_KEY — Chave secreta Flask para assinatura de sessões

Módulos Plugáveis

• modules.sso — SSO e autenticação
• modules.governanca_indices — Governança de Índices Econômicos

Gerencia índices econômicos como IPCA, INPC, IGP-M, UFESP e EC 113/2021, com controle de versão, conferência e auditoria completa.

Rotas

• UI: /governanca-indices/
• API: /api/governanca-indices/...

Modelos de Banco

• gi_indice — codigo, nome, fonte, tipo_valor, periodicidade, unidade, metodo_atualizacao, ativo, robot_tipo, robot_config_json
• gi_indice_valor — indice_id, competencia, valor, status, origem
• gi_indice_conferencia — valor_id, resultado, conferido_por
• gi_audit_log — entidade, entidade_id, acao, usuario, origem, diff_json

Fluxo de Status dos Valores

Robôs Automáticos

• BCB_SGS_JSON — Banco Central do Brasil, API SGS (JSON)
• SP_UFESP_SEFAZ_HTML — UFESP, portal SEFAZ-SP (HTML scraping)
• TJSP_PDF_MATRIX — TJSP, extração de PDFs com matriz de valores
• TJSP_COMUNICADO_SCRAPER — TJSP, scraper de comunicados

• URL: https://monitorjuridico.nccsofts.com.br
• Stack: Flask + SQLite, servido via Unix socket
• Funcionalidade: Monitoramento de processos judiciais via API Escavador
• Integração SSO: Cookie compartilhado .nccsofts.com.br

Variáveis de Ambiente

• ESCAVADOR_TOKEN — Token de acesso à API Escavador
• WEBHOOK_AUTH_TOKEN — Token de autenticação para webhooks

Rotas Principais

Auto-discover de processos a partir de documentos (CNPJs/CPFs) cadastrados na watchlist.

• Config versionada: Contabo/nginx/nccsofts_portal
• No servidor: /etc/nginx/sites-available/nccsofts_portal
• SSL: Let's Encrypt (certbot), renovação automática

Headers de Segurança

• X-Content-Type-Options: nosniff
• X-Frame-Options: DENY
• Referrer-Policy: strict-origin-when-cross-origin
• Content-Security-Policy: frame-ancestors 'none'
• Permissions-Policy: geolocation=(), microphone=(), camera=()

Proxy Reverso

Requisições para /sso/* são encaminhadas para http://127.0.0.1:8000 (Gunicorn BlueDeploy).

O subdomínio docs.nccsofts.com.br serve arquivos estáticos de /var/www/nccsofts-docs/ e faz proxy apenas de /sso/api/me para o BlueDeploy.

O repositório está clonado em /opt/bluedeploy/ no servidor. Para aplicar mudanças após um merge na branch principal:

cd /opt/bluedeploy && git pull
sudo cp Contabo/www/index.html /var/www/nccsofts/index.html
sudo cp Contabo/www/docs.html /var/www/nccsofts/docs.html
sudo cp Contabo/www/status.html /var/www/nccsofts/status.html
sudo cp Contabo/www/docs.html /var/www/nccsofts-docs/index.html
sudo chown www-data:www-data /var/www/nccsofts/*.html /var/www/nccsofts-docs/*.html
sudo systemctl restart bluedeploy

Primeira Configuração do Subdomínio docs

Para configurar o subdomínio docs.nccsofts.com.br pela primeira vez, use o script de setup:

sudo bash /opt/bluedeploy/Contabo/scripts/setup_docs_ssl.sh

O script cria o diretório /var/www/nccsofts-docs/, instala a config nginx e obtém o certificado SSL via certbot.

Paleta de Cores

Componentes

• .card — Painel com fundo semitransparente, borda e border-radius 18px
• .badge — Tag compacta com variantes .yellow e .green
• .btn — Botão com variante .primary (dourado)
• .pill — Pílula de navegação/ação
• .nav-item — Item de âncora de navegação interna
• .logo-badge — Badge do logo no header com fundo dourado

Tipografia

Stack: ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Arial

Responsividade

Breakpoint principal: @media(max-width:768px) — ajusta padding, font-size e layout de tabelas.

Animações

fadein — opacity 0 para 1 com translateY 8px para 0, duração 0.45s ease-out.