@danhachuel/pandanews 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 Todas as versões publicadas são registradas aqui antes do publish (regra em AGENTS.md). A etiqueta visual usa PATCH de dois dígitos (ex.: 0.1.00); o registry npm normaliza para a versão canônica (ex.: 0.1.0).
 
+## 0.3.01 (2026-10-25)
+
+- **Páginas legais e de verificação** em `legal/` (padrão AutoPost-Lunga, adaptado ao PandaNews): `index.html` (apresentação do app, funcionalidades e provedores de API), `terms.html` (Termos de Uso em pt-BR) e `privacy.html` (Política de Privacidade em conformidade com a LGPD — Lei 13.709/2018)
+- Backend serve as páginas em `/legal/index.html`, `/legal/terms.html` e `/legal/privacy.html` (whitelist de arquivos, servidos também via UI em `/legal/*` através do proxy)
+- Conteúdo específico do PandaNews: dados de configuração de blogs, feeds RSS, chaves de API locais (NVIDIA NIM, Google Gemini, Supabase), compartilhamento mínimo com provedores (apenas prompts/contexto editorial), direitos do titular exercidos localmente, armazenamento em SQLite (`data/pandanews.db`) e imagens em `data/imagens/`
+- `legal/` passa a fazer parte do tarball npm (`files`)
+
 ## 0.3.00 (2026-10-24)
 
 - **Pipeline de notícias completo** (Fase 3): coleta RSS (feedparser) → filtragem por relevância (palavras-chave do tema + bônus de região) → redação via LLM com fallback NVIDIA → Gemini (resposta em JSON: título, resumo, corpo) → imagem fotojornalística via Gemini Image salva em `data/imagens/`

package/backend/app/main.py

@@ -10,7 +10,7 @@ from contextlib import asynccontextmanager
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 
-from backend.app.routers import automacao, blogs, configuracoes, dashboard, imagens, llm, logs, noticias
+from backend.app.routers import automacao, blogs, configuracoes, dashboard, imagens, legal, llm, logs, noticias
 from backend.core.database import SessionLocal, init_db
 from backend.core.llm_router import get_config
 
@@ -31,7 +31,7 @@ async def lifespan(_: FastAPI):
     scheduler.parar()
 
 
-app = FastAPI(title="PandaNews API", version="0.3.0", lifespan=lifespan)
+app = FastAPI(title="PandaNews API", version="0.3.1", lifespan=lifespan)
 
 app.add_middleware(
     CORSMiddleware,
@@ -48,6 +48,7 @@ app.include_router(noticias.router, prefix="/api/v1")
 app.include_router(imagens.router, prefix="/api/v1")
 app.include_router(automacao.router, prefix="/api/v1")
 app.include_router(logs.router, prefix="/api/v1")
+app.include_router(legal.router)  # /legal/* na raiz (URLs de verificação)
 
 
 @app.get("/api/v1/health")

package/backend/app/routers/legal.py

@@ -0,0 +1,35 @@
+"""Páginas legais e de verificação (/legal) — estáticas.
+
+Servem como URL de verificação do app junto aos provedores de API
+(Google Gemini, NVIDIA NIM, Supabase) e como documentos legais oficiais.
+"""
+from __future__ import annotations
+
+from fastapi import APIRouter, HTTPException
+from fastapi.responses import FileResponse
+
+from backend.core.config import LEGAL_DIR
+
+router = APIRouter(prefix="/legal", tags=["legal"])
+
+ARQUIVOS_PERMITIDOS = {"index.html", "terms.html", "privacy.html"}
+
+
+def _servir(nome: str) -> FileResponse:
+    if nome not in ARQUIVOS_PERMITIDOS:
+        raise HTTPException(status_code=404, detail="Página não encontrada")
+    caminho = LEGAL_DIR / nome
+    if not caminho.exists():
+        raise HTTPException(status_code=404, detail="Página não encontrada")
+    return FileResponse(caminho, media_type="text/html; charset=utf-8")
+
+
+@router.get("")
+@router.get("/")
+def legal_index() -> FileResponse:
+    return _servir("index.html")
+
+
+@router.get("/{nome}")
+def legal_pagina(nome: str) -> FileResponse:
+    return _servir(nome)

package/backend/core/config.py

@@ -29,6 +29,10 @@ IMAGES_DIR = DATA_DIR / "imagens"
 DB_PATH = DATA_DIR / "pandanews.db"
 DB_URL = os.environ.get("PANDANEWS_DB_URL", f"sqlite:///{DB_PATH}")
 
+# Raiz do pacote (backend/core/config.py -> parents[2])
+PKG_DIR = Path(__file__).resolve().parents[2]
+LEGAL_DIR = PKG_DIR / "legal"
+
 SUPABASE_URL = os.environ.get("SUPABASE_URL", "")
 SUPABASE_SERVICE_ROLE_KEY = os.environ.get("SUPABASE_SERVICE_ROLE_KEY", "")
 

package/legal/index.html

@@ -0,0 +1,218 @@
+<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>PandaNews - Geração e Automação de Blogs de Notícias com IA</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            background: linear-gradient(135deg, #0b1220 0%, #14532d 100%);
+            min-height: 100vh;
+            padding: 40px 20px;
+        }
+        .container { max-width: 800px; margin: 0 auto; }
+        .card {
+            background: #ffffff;
+            border-radius: 20px;
+            padding: 40px;
+            margin-bottom: 30px;
+            box-shadow: 0 20px 40px rgba(0,0,0,0.25);
+        }
+        .badge {
+            background: linear-gradient(135deg, #22c55e 0%, #16a34a 100%);
+            color: #052e16;
+            padding: 8px 16px;
+            border-radius: 50px;
+            display: inline-block;
+            font-size: 0.9em;
+            font-weight: 600;
+            margin-bottom: 20px;
+        }
+        h1 { color: #0b1220; font-size: 2.4em; margin-bottom: 10px; }
+        h2 { color: #14532d; margin: 25px 0 15px 0; font-size: 1.6em; }
+        p { color: #475569; line-height: 1.6; margin: 10px 0; }
+        .feature-grid {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+            gap: 20px;
+            margin: 25px 0;
+        }
+        .feature-item {
+            background: #f8faf9;
+            padding: 20px;
+            border-radius: 15px;
+            border-left: 4px solid #22c55e;
+            transition: transform 0.2s;
+        }
+        .feature-item:hover { transform: translateY(-4px); }
+        .feature-item h3 { margin-bottom: 10px; font-size: 1.15em; color: #0b1220; }
+        .feature-item p { color: #64748b; line-height: 1.5; margin: 6px 0; }
+        .api-grid {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+            gap: 20px;
+            margin: 25px 0;
+        }
+        .api-item {
+            background: #f8faf9;
+            padding: 20px;
+            border-radius: 15px;
+            border-left: 4px solid;
+        }
+        .api-nvidia { border-left-color: #76b900; }
+        .api-gemini { border-left-color: #4285f4; }
+        .api-supabase { border-left-color: #3ecf8e; }
+        .api-item h3 { margin-bottom: 8px; font-size: 1.1em; color: #0b1220; }
+        .api-item p { color: #64748b; font-size: 0.92em; line-height: 1.5; margin: 6px 0; }
+        code {
+            background: #e8f0ea;
+            color: #14532d;
+            padding: 2px 6px;
+            border-radius: 4px;
+            font-size: 0.85em;
+        }
+        .links {
+            margin: 30px 0 20px 0;
+            padding: 22px;
+            background: #ecfdf5;
+            border-radius: 15px;
+            text-align: center;
+        }
+        .links a {
+            display: inline-block;
+            min-height: 44px;
+            line-height: 44px;
+            padding: 0 14px;
+            color: #15803d;
+            text-decoration: none;
+            margin: 4px 8px;
+            font-weight: 600;
+            border-radius: 10px;
+        }
+        .links a:hover { background: #d1fae5; }
+        footer { text-align: center; color: rgba(255,255,255,0.85); margin-top: 30px; line-height: 1.6; }
+        .contact {
+            background: #fff8e6;
+            padding: 18px;
+            border-radius: 10px;
+            margin-top: 20px;
+            line-height: 1.7;
+        }
+        .contact a { color: #15803d; }
+        .pipeline {
+            background: #0b1220;
+            color: #e2e8f0;
+            padding: 18px 20px;
+            border-radius: 15px;
+            font-size: 0.95em;
+            line-height: 1.8;
+        }
+        .pipeline strong { color: #22c55e; }
+        @media (max-width: 600px) {
+            .card { padding: 25px; }
+            h1 { font-size: 1.7em; }
+            h2 { font-size: 1.35em; }
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="card">
+            <div class="badge">🐻 Automação Editorial com IA</div>
+            <h1>PandaNews</h1>
+            <p style="font-size: 1.15em; color: #334155; margin-bottom: 15px;">
+                Geração e automação de blogs de notícias com Inteligência Artificial — SaaS local para criação e operação de múltiplos blogs segmentados por tema e região.
+            </p>
+            <p>
+                O PandaNews é uma ferramenta <strong>local</strong> (executada na máquina do usuário via <code>npx</code>) de automação editorial:
+                coleta pautas em feeds RSS configurados pelo usuário, redige notícias com modelos de linguagem de IA (LLMs)
+                e produz imagens ilustrativas, organizando tudo em múltiplos blogs com revisão humana e agendamento automático.
+            </p>
+
+            <h2>⚙️ Funcionalidades</h2>
+            <div class="feature-grid">
+                <div class="feature-item">
+                    <h3>📰 Múltiplos blogs por tema e região</h3>
+                    <p>Gestão de blogs segmentados por tema — esporte, política, economia, tecnologia, geral — e por recorte regional (Brasil, Espanha, São Paulo, Rio de Janeiro etc.), cada um com fontes e estilo editorial próprios.</p>
+                </div>
+                <div class="feature-item">
+                    <h3>📡 Coleta via feeds RSS</h3>
+                    <p>Pautas coletadas automaticamente das fontes RSS configuradas pelo usuário, com filtragem por relevância (tema e região) e deduplicação de itens.</p>
+                </div>
+                <div class="feature-item">
+                    <h3>🤖 Redação com LLM multi-provedor</h3>
+                    <p>Geração de notícias (título, resumo e corpo) com fallback por prioridade: <strong>NVIDIA NIM → Google Gemini</strong>. O provedor que responde é registrado em cada notícia.</p>
+                </div>
+                <div class="feature-item">
+                    <h3>🎨 Imagens com IA</h3>
+                    <p>Imagens ilustrativas em estilo fotojornalístico geradas pela API do Google Gemini Image a partir de palavras-chave da notícia, com geração manual por prompt livre.</p>
+                </div>
+                <div class="feature-item">
+                    <h3>👁️ Revisão humana</h3>
+                    <p>Fluxo editorial completo: rascunho → aprovado → publicado. Toda notícia nasce em rascunho para revisão, edição manual ou regeneração antes da aprovação.</p>
+                </div>
+                <div class="feature-item">
+                    <h3>⏱️ Agendamento automático</h3>
+                    <p>Agendador com frequência configurável por blog, toggle global e execução imediata — com logs de execução por etapa (coleta, redação, imagem).</p>
+                </div>
+                <div class="feature-item">
+                    <h3>💾 Armazenamento local</h3>
+                    <p>Por padrão, 100% local em SQLite (<code>data/pandanews.db</code>), com opção de migração para Supabase quando o usuário fornecer credenciais.</p>
+                </div>
+                <div class="feature-item">
+                    <h3>📊 Dashboard com métricas</h3>
+                    <p>Métricas de geração (últimos 7 dias), notícias pendentes de revisão, status do agendador, checklist de onboarding e últimos erros registrados.</p>
+                </div>
+            </div>
+
+            <h2>🔌 Como funciona</h2>
+            <div class="pipeline">
+                <strong>Pipeline de geração:</strong> coleta RSS → filtragem por relevância → redação via LLM
+                (NVIDIA NIM → Google Gemini) → imagem via Gemini Image → <strong>rascunho</strong> → revisão humana → aprovado/publicado.
+                <br>
+                O agendador repete o ciclo para cada blog ativo conforme sua frequência configurada.
+            </div>
+
+            <h2>🧩 Provedores de API utilizados</h2>
+            <div class="api-grid">
+                <div class="api-item api-nvidia">
+                    <h3>🟩 NVIDIA NIM</h3>
+                    <p><strong>API:</strong> inference (endpoint compatível com OpenAI)</p>
+                    <p><strong>Uso:</strong> geração de texto das notícias (provedor primário do fallback)</p>
+                    <p>Chave de API fornecida pelo próprio usuário, armazenada localmente.</p>
+                </div>
+                <div class="api-item api-gemini">
+                    <h3>🔵 Google Gemini</h3>
+                    <p><strong>APIs:</strong> modelo de linguagem (fallback de texto) e Gemini Image (imagens ilustrativas)</p>
+                    <p><strong>Uso:</strong> redação alternativa e geração de imagens fotojornalísticas</p>
+                    <p>Chave de API fornecida pelo próprio usuário, armazenada localmente.</p>
+                </div>
+                <div class="api-item api-supabase">
+                    <h3>🟢 Supabase</h3>
+                    <p><strong>API:</strong> banco gerenciado (opcional)</p>
+                    <p><strong>Uso:</strong> backend de dados alternativo, apenas se o usuário optar explicitamente e fornecer suas credenciais</p>
+                    <p>Por padrão, os dados permanecem em SQLite local.</p>
+                </div>
+            </div>
+
+            <div class="links">
+                <a href="privacy.html">🔒 Política de Privacidade</a>
+                <a href="terms.html">📜 Termos de Uso</a>
+            </div>
+
+            <div class="contact">
+                <strong>📧 Desenvolvedor:</strong> Dan Hachuel<br>
+                <!-- TODO: confirmar e-mail -->
+                <strong>📩 Contato:</strong> <a href="mailto:danchannels96@gmail.com">danchannels96@gmail.com</a><br>
+                <strong>📍 Propósito:</strong> aplicação pessoal de automação editorial para blogs próprios do usuário.
+            </div>
+        </div>
+        <footer>
+            <p>© 2026 PandaNews — Dan Hachuel</p>
+            <p>Este site é usado para verificação da aplicação junto aos provedores de API utilizados: Google Gemini, NVIDIA NIM e Supabase.</p>
+        </footer>
+    </div>
+</body>
+</html>

package/legal/privacy.html

@@ -0,0 +1,207 @@
+<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Política de Privacidade - PandaNews</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            background: linear-gradient(135deg, #0b1220 0%, #14532d 100%);
+            min-height: 100vh;
+            padding: 40px 20px;
+        }
+        .container { max-width: 800px; margin: 0 auto; }
+        .card {
+            background: #ffffff;
+            border-radius: 20px;
+            padding: 40px;
+            margin-bottom: 30px;
+            box-shadow: 0 20px 40px rgba(0,0,0,0.25);
+        }
+        .badge {
+            background: linear-gradient(135deg, #22c55e 0%, #16a34a 100%);
+            color: #052e16;
+            padding: 8px 16px;
+            border-radius: 50px;
+            display: inline-block;
+            font-size: 0.9em;
+            font-weight: 600;
+            margin-bottom: 20px;
+        }
+        h1 { color: #0b1220; font-size: 2.2em; margin-bottom: 10px; }
+        h2 { color: #14532d; margin: 28px 0 12px 0; font-size: 1.45em; }
+        h3 { color: #166534; margin: 18px 0 8px 0; font-size: 1.15em; }
+        p { color: #475569; line-height: 1.65; margin: 10px 0; }
+        ul, ol { margin: 10px 0 10px 28px; color: #475569; line-height: 1.65; }
+        li { margin: 6px 0; }
+        strong { color: #0b1220; }
+        code {
+            background: #e8f0ea;
+            color: #14532d;
+            padding: 2px 6px;
+            border-radius: 4px;
+            font-size: 0.85em;
+        }
+        a { color: #15803d; text-decoration: none; }
+        a:hover { text-decoration: underline; }
+        .destaque {
+            background: #ecfdf5;
+            border-left: 4px solid #22c55e;
+            padding: 14px 18px;
+            border-radius: 10px;
+            margin: 15px 0;
+            color: #14532d;
+        }
+        .links {
+            margin: 30px 0 20px 0;
+            padding: 22px;
+            background: #ecfdf5;
+            border-radius: 15px;
+            text-align: center;
+        }
+        .links a {
+            display: inline-block;
+            min-height: 44px;
+            line-height: 44px;
+            padding: 0 14px;
+            color: #15803d;
+            text-decoration: none;
+            margin: 4px 8px;
+            font-weight: 600;
+            border-radius: 10px;
+        }
+        .links a:hover { background: #d1fae5; }
+        footer { text-align: center; color: rgba(255,255,255,0.85); margin-top: 30px; line-height: 1.6; }
+        .contact {
+            background: #fff8e6;
+            padding: 18px;
+            border-radius: 10px;
+            margin-top: 20px;
+            line-height: 1.7;
+        }
+        .contact a { color: #15803d; }
+        @media (max-width: 600px) {
+            .card { padding: 25px; }
+            h1 { font-size: 1.6em; }
+            h2 { font-size: 1.25em; }
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="card">
+            <div class="badge">🔒 Documento Legal</div>
+            <h1>Política de Privacidade</h1>
+            <p><strong>Data de vigência:</strong> 25 de outubro de 2026</p>
+            <p><strong>Aplicação:</strong> PandaNews — geração e automação de blogs de notícias com IA</p>
+
+            <p>
+                Esta Política de Privacidade descreve como o PandaNews trata dados pessoais e informações do usuário,
+                em conformidade com a <strong>Lei Geral de Proteção de Dados Pessoais (LGPD — Lei nº 13.709/2018)</strong>.
+            </p>
+            <div class="destaque">
+                <strong>Princípio fundamental do PandaNews:</strong> o aplicativo é <strong>100% local</strong>. Ele é executado
+                na máquina do próprio usuário via <code>npx</code>, e todos os dados — configurações, conteúdo e credenciais —
+                residem no banco SQLite local (<code>data/pandanews.db</code>). <strong>Nenhum dado é enviado a servidores
+                do desenvolvedor.</strong>
+            </div>
+
+            <h2>1. Dados coletados</h2>
+            <p>O PandaNews trata as seguintes categorias de dados, todas armazenadas localmente na máquina do usuário:</p>
+            <ul>
+                <li><strong>Dados de configuração de blogs:</strong> nome, tema (esporte, política, economia, tecnologia, geral), região, fontes RSS, estilo editorial, frequência de geração e status.</li>
+                <li><strong>Conteúdo coletado de feeds RSS públicos:</strong> títulos, resumos e links de notícias das fontes configuradas pelo usuário.</li>
+                <li><strong>Conteúdo gerado por IA:</strong> notícias (título, resumo, corpo), imagens ilustrativas e o provedor de LLM que gerou cada texto.</li>
+                <li><strong>Chaves de API fornecidas pelo usuário:</strong> NVIDIA NIM, Google Gemini e Supabase — armazenadas localmente, no banco SQLite do próprio usuário.</li>
+                <li><strong>Dados de uso da plataforma:</strong> logs de execução (sucessos e erros por etapa), status do agendador e estatísticas de geração — visíveis apenas para o próprio usuário.</li>
+                <li><strong>Tokens e credenciais do Supabase:</strong> apenas se o usuário optar explicitamente por esse backend.</li>
+            </ul>
+
+            <h2>2. Finalidade do tratamento</h2>
+            <ul>
+                <li>Coleta e agregação de notícias de fontes públicas para fins editoriais.</li>
+                <li>Geração de conteúdo textual e visual com Inteligência Artificial.</li>
+                <li>Automação de geração conforme a frequência configurada por blog.</li>
+                <li>Produção de estatísticas e logs de execução para o próprio usuário acompanhar a operação.</li>
+            </ul>
+
+            <h2>3. Compartilhamento de dados</h2>
+            <p>O PandaNews é arquitetado para compartilhar <strong>o mínimo necessário</strong>, apenas com os provedores de API
+            cujas chaves o próprio usuário configura:</p>
+            <ul>
+                <li><strong>NVIDIA NIM (LLM):</strong> apenas o texto dos prompts e o contexto da notícia (título e resumo da fonte) são enviados para a redação. <strong>Nenhum dado pessoal do usuário é compartilhado.</strong></li>
+                <li><strong>Google Gemini (LLM de fallback):</strong> mesmo escopo do item acima — apenas prompts e contexto editorial.</li>
+                <li><strong>Google Gemini Image API:</strong> apenas prompts visuais derivados do conteúdo da notícia (palavras-chave do título/resumo).</li>
+                <li><strong>Supabase:</strong> apenas se o usuário optar explicitamente por esse backend, e apenas os dados que ele próprio decidir sincronizar.</li>
+                <li>O PandaNews <strong>não compartilha dados com terceiros</strong> para fins publicitários, de marketing ou de perfilação, e <strong>não vende dados</strong> sob nenhuma circunstância.</li>
+            </ul>
+
+            <h2>4. Armazenamento e localização</h2>
+            <ul>
+                <li>Por padrão, todos os dados residem no <strong>SQLite local</strong> na máquina do usuário: <code>data/pandanews.db</code>.</li>
+                <li>As imagens geradas residem em <code>data/imagens/</code>, também na máquina do usuário.</li>
+                <li>O runtime (Python portátil e dependências) fica em <code>~/.pandanews/</code>, separado do pacote npm.</li>
+                <li><strong>Nenhum dado é enviado a servidores do desenvolvedor do PandaNews.</strong> O tráfego externo limita-se às chamadas de API descritas na seção 3 e à leitura dos feeds RSS configurados.</li>
+            </ul>
+
+            <h2>5. Direitos do titular (LGPD, art. 18)</h2>
+            <p>Nos termos da LGPD, o titular dos dados possui direito à confirmação do tratamento, acesso, correção,
+            anonimização, portabilidade e eliminação dos dados. Como o PandaNews é uma aplicação local, <strong>o próprio
+            usuário exerce esses direitos diretamente</strong>:</p>
+            <ul>
+                <li>No banco de dados local (<code>data/pandanews.db</code>), acessível com qualquer ferramenta de SQLite;</li>
+                <li>Pela interface do aplicativo (exclusão de blogs e notícias, edição de configurações);</li>
+                <li>Para dados eventualmente sincronizados ao Supabase, diretamente no painel do Supabase, que pertence ao próprio usuário.</li>
+            </ul>
+            <p>Dúvidas sobre tratamento de dados podem ser enviadas ao canal de contato indicado ao final deste documento.</p>
+
+            <h2>6. Segurança</h2>
+            <ul>
+                <li>As chaves de API são armazenadas <strong>localmente</strong> no SQLite da própria máquina, sem criptografia adicional — cabe ao usuário proteger o acesso ao seu sistema.</li>
+                <li>Recomenda-se <strong>não compartilhar</strong> o arquivo <code>data/pandanews.db</code> nem o arquivo <code>.env</code> do projeto, pois ambos podem conter credenciais.</li>
+                <li>O aplicativo escuta apenas em <code>127.0.0.1</code> (interface local), não expondo os serviços à rede externa.</li>
+            </ul>
+
+            <h2>7. Cookies</h2>
+            <p>O PandaNews é uma aplicação local servida em <code>localhost</code> e <strong>não utiliza cookies de rastreamento
+            de terceiros</strong>, analytics externos ou pixels de publicidade. Cookies de sessão, caso existam na interface
+            local, servem apenas ao funcionamento da própria UI.</p>
+
+            <h2>8. Transferência internacional</h2>
+            <p>As chamadas às APIs de LLM e imagem (NVIDIA NIM, Google Gemini) implicam envio dos prompts aos servidores
+            desses provedores, que podem estar localizados fora do Brasil, regidos pelos termos de uso e políticas de
+            privacidade de cada provedor. O PandaNews não envia a esses provedores nenhum dado pessoal além do conteúdo
+            dos prompts editoriais descritos na seção 3.</p>
+
+            <h2>9. Alterações desta Política</h2>
+            <p>Esta Política de Privacidade pode ser atualizada a qualquer momento. A versão vigente será publicada neste
+            endereço, com a data de vigência atualizada. O uso contínuo do PandaNews após alterações implica concordância
+            com a versão vigente.</p>
+
+            <h2>10. Contato</h2>
+            <p>Para exercer direitos de titular ou esclarecer dúvidas sobre esta Política:</p>
+            <ul>
+                <!-- TODO: confirmar e-mail -->
+                <li>Por e-mail: <a href="mailto:danchannels96@gmail.com">danchannels96@gmail.com</a></li>
+            </ul>
+
+            <div class="links">
+                <a href="index.html">🏠 Voltar para Home</a>
+                <a href="terms.html">📜 Termos de Uso</a>
+            </div>
+
+            <div class="contact">
+                <strong>📧 Desenvolvedor:</strong> Dan Hachuel<br>
+                <!-- TODO: confirmar e-mail -->
+                <strong>📩 Contato:</strong> <a href="mailto:danchannels96@gmail.com">danchannels96@gmail.com</a>
+            </div>
+        </div>
+        <footer>
+            <p>© 2026 PandaNews — Dan Hachuel</p>
+            <p>Este site é usado para verificação da aplicação junto aos provedores de API utilizados: Google Gemini, NVIDIA NIM e Supabase.</p>
+        </footer>
+    </div>
+</body>
+</html>

package/legal/terms.html

@@ -0,0 +1,185 @@
+<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Termos de Uso - PandaNews</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            background: linear-gradient(135deg, #0b1220 0%, #14532d 100%);
+            min-height: 100vh;
+            padding: 40px 20px;
+        }
+        .container { max-width: 800px; margin: 0 auto; }
+        .card {
+            background: #ffffff;
+            border-radius: 20px;
+            padding: 40px;
+            margin-bottom: 30px;
+            box-shadow: 0 20px 40px rgba(0,0,0,0.25);
+        }
+        .badge {
+            background: linear-gradient(135deg, #22c55e 0%, #16a34a 100%);
+            color: #052e16;
+            padding: 8px 16px;
+            border-radius: 50px;
+            display: inline-block;
+            font-size: 0.9em;
+            font-weight: 600;
+            margin-bottom: 20px;
+        }
+        h1 { color: #0b1220; font-size: 2.2em; margin-bottom: 10px; }
+        h2 { color: #14532d; margin: 28px 0 12px 0; font-size: 1.45em; }
+        p { color: #475569; line-height: 1.65; margin: 10px 0; }
+        ul, ol { margin: 10px 0 10px 28px; color: #475569; line-height: 1.65; }
+        li { margin: 6px 0; }
+        strong { color: #0b1220; }
+        code {
+            background: #e8f0ea;
+            color: #14532d;
+            padding: 2px 6px;
+            border-radius: 4px;
+            font-size: 0.85em;
+        }
+        a { color: #15803d; text-decoration: none; }
+        a:hover { text-decoration: underline; }
+        .alerta {
+            background: #fff8e6;
+            border-left: 4px solid #f59e0b;
+            padding: 14px 18px;
+            border-radius: 10px;
+            margin: 15px 0;
+            color: #78350f;
+        }
+        .links {
+            margin: 30px 0 20px 0;
+            padding: 22px;
+            background: #ecfdf5;
+            border-radius: 15px;
+            text-align: center;
+        }
+        .links a {
+            display: inline-block;
+            min-height: 44px;
+            line-height: 44px;
+            padding: 0 14px;
+            color: #15803d;
+            text-decoration: none;
+            margin: 4px 8px;
+            font-weight: 600;
+            border-radius: 10px;
+        }
+        .links a:hover { background: #d1fae5; }
+        footer { text-align: center; color: rgba(255,255,255,0.85); margin-top: 30px; line-height: 1.6; }
+        .contact {
+            background: #fff8e6;
+            padding: 18px;
+            border-radius: 10px;
+            margin-top: 20px;
+            line-height: 1.7;
+        }
+        .contact a { color: #15803d; }
+        @media (max-width: 600px) {
+            .card { padding: 25px; }
+            h1 { font-size: 1.6em; }
+            h2 { font-size: 1.25em; }
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="card">
+            <div class="badge">📜 Documento Legal</div>
+            <h1>Termos de Uso</h1>
+            <p><strong>Data de vigência:</strong> 25 de outubro de 2026</p>
+
+            <h2>1. Aceitação</h2>
+            <p>
+                Ao instalar e usar o PandaNews, o usuário concorda integralmente com estes Termos de Uso e com a
+                <a href="privacy.html">Política de Privacidade</a>. Caso não concorde com qualquer disposição, o usuário
+                deve desinstalar e cessar o uso da ferramenta.
+            </p>
+
+            <h2>2. Descrição do Serviço</h2>
+            <p>
+                O PandaNews é uma ferramenta <strong>local</strong> (executada na máquina do usuário via <code>npx</code>)
+                para geração e automação de blogs de notícias com Inteligência Artificial: coleta de pautas em feeds RSS,
+                redação com LLMs multi-provedor (fallback NVIDIA NIM → Google Gemini), geração de imagens ilustrativas,
+                revisão humana e agendamento automático por blog.
+            </p>
+            <div class="alerta">
+                O serviço é fornecido <strong>"como está"</strong>, sem garantias de disponibilidade contínua, precisão
+                editorial ou adequação a fins específicos. A qualidade do conteúdo gerado depende dos modelos de IA e das
+                fontes configuradas pelo usuário.
+            </div>
+
+            <h2>3. Responsabilidades do usuário</h2>
+            <ul>
+                <li><strong>Conteúdo gerado:</strong> o usuário é o único responsável pelas notícias, imagens e textos produzidos, e pela verificação de sua veracidade antes de qualquer publicação.</li>
+                <li><strong>Chaves de API:</strong> o usuário responde pelas chaves que fornecer (NVIDIA NIM, Google Gemini, Supabase) e pelo cumprimento dos termos de uso de cada provedor, inclusive cotas, limites de uso e políticas de conteúdo.</li>
+                <li><strong>Curadoria das fontes RSS:</strong> o usuário garante que as fontes configuradas respeitam direitos autorais e não violam termos de terceiros.</li>
+                <li><strong>Proibições:</strong> é vedado usar o PandaNews para gerar ou difundir desinformação, difamação, discurso de ódio, spam, assédio ou qualquer conteúdo ilegal.</li>
+                <li><strong>Termos de plataformas:</strong> é vedado usar o PandaNews para violar os termos de uso das plataformas cujas APIs sejam integradas.</li>
+            </ul>
+
+            <h2>4. Limitação de responsabilidade</h2>
+            <p>O PandaNews e seu desenvolvedor <strong>não se responsabilizam</strong> por:</p>
+            <ul>
+                <li>Bloqueios, penalidades ou restrições impostas por plataformas externas (Google, NVIDIA, Supabase) em decorrência do uso das APIs;</li>
+                <li>Conteúdo gerado por IA que contenha imprecisões, vieses ou erros factuais — a revisão humana é etapa obrigatória e de responsabilidade do usuário;</li>
+                <li>Danos indiretos, lucros cessantes ou perda de dados decorrentes do uso da ferramenta;</li>
+                <li>Uso indevido das chaves de API do usuário por terceiros que tenham acesso à sua máquina.</li>
+            </ul>
+
+            <h2>5. Propriedade Intelectual</h2>
+            <ul>
+                <li>O código do PandaNews é de uso pessoal e <strong>não pode ser revendido ou redistribuído comercialmente</strong> sem autorização expressa do desenvolvedor.</li>
+                <li>O conteúdo gerado com IA pertence ao usuário, observadas as limitações e políticas de uso dos provedores de LLM e de imagem.</li>
+                <li>Os feeds RSS coletados são de propriedade de seus respectivos veículos; o usuário deve respeitar os termos de uso de cada fonte.</li>
+            </ul>
+
+            <h2>6. Proteção de dados</h2>
+            <p>
+                O tratamento de dados pelo PandaNews obedece à <a href="privacy.html">Política de Privacidade</a>, em
+                conformidade com a LGPD (Lei nº 13.709/2018). Por se tratar de aplicação local, os dados permanecem na
+                máquina do usuário, que exerce diretamente seus direitos de titular.
+            </p>
+
+            <h2>7. Alterações nos Termos</h2>
+            <p>
+                O desenvolvedor pode atualizar estes Termos a qualquer momento, publicando a nova versão no repositório.
+                O uso contínuo após alterações implica aceitação da versão vigente.
+            </p>
+
+            <h2>8. Foro</h2>
+            <p>
+                Fica eleito o foro da comarca do desenvolvedor (Brasil) para dirimir quaisquer controvérsias decorrentes
+                destes Termos, com renúncia expressa a qualquer outro, por mais privilegiado que seja.
+            </p>
+
+            <h2>9. Contato</h2>
+            <ul>
+                <!-- TODO: confirmar e-mail -->
+                <li>Por e-mail: <a href="mailto:danchannels96@gmail.com">danchannels96@gmail.com</a></li>
+            </ul>
+
+            <div class="links">
+                <a href="index.html">🏠 Voltar para Home</a>
+                <a href="privacy.html">🔒 Política de Privacidade</a>
+            </div>
+
+            <div class="contact">
+                <strong>📧 Desenvolvedor:</strong> Dan Hachuel<br>
+                <!-- TODO: confirmar e-mail -->
+                <strong>📩 Contato:</strong> <a href="mailto:danchannels96@gmail.com">danchannels96@gmail.com</a>
+            </div>
+        </div>
+        <footer>
+            <p>© 2026 PandaNews — Dan Hachuel</p>
+            <p>Este site é usado para verificação da aplicação junto aos provedores de API utilizados: Google Gemini, NVIDIA NIM e Supabase.</p>
+        </footer>
+    </div>
+</body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/pandanews",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "SaaS local de criação e automação de múltiplos blogs de notícias com IA (FastAPI + React + Tailwind).",
   "license": "MIT",
   "type": "module",
@@ -12,6 +12,7 @@
     "scripts/",
     "backend/",
     "frontend/dist/",
+    "legal/",
     "CHANGELOG.md",
     "README.md"
   ],

package/scripts/start.js

@@ -104,7 +104,7 @@ let uiServer = null;
 function createUiServer() {
   const distDir = join(PKG_ROOT, 'frontend', 'dist');
   return createServer((req, res) => {
-    if (req.url.startsWith('/api')) {
+    if (req.url.startsWith('/api') || req.url.startsWith('/legal')) {
       proxyApi(req, res);
       return;
     }