@danhachuel/pandanews 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.1.02 (2026-10-23)
+
+- Porta padrão da UI alterada de 3030 para **4030** (sobrescrevível via `PANDANEWS_UI_PORT`)
+- Fallback automático de porta: se 4030 estiver ocupada, o PandaNews tenta a seguinte (4031, 4032, ...) em até 20 tentativas, com mensagem clara se nenhuma estiver livre
+- CORS do backend passa a aceitar localhost/127.0.0.1 em qualquer porta, acompanhando a porta dinâmica da UI
+
+## 0.1.01 (2026-10-23)
+
+- README reescrito para o fluxo de um único comando via npx (padrão Thunderbolt): `npx @danhachuel/pandanews` instala tudo junto e sobe o app; removidas as instruções manuais de desenvolvimento (pip, uvicorn, npm)
+- Instalador completo (`pandanews install`): download de Python 3.12.7 portátil (python-build-standalone), criação de virtualenv e instalação de todas as dependências do backend em um único passo — nenhum Python pré-instalado necessário (antecipação do núcleo da Fase 4)
+- `pandanews` (start) agora sobe o backend FastAPI em 127.0.0.1:8000, serve página em 127.0.0.1:3030 e abre o navegador automaticamente; instala o runtime sozinho na primeira execução
+- Tratamento de porta ocupada (EADDRINUSE) com mensagem clara; portas configuráveis via `PANDANEWS_API_PORT` / `PANDANEWS_UI_PORT` e sem processos órfãos no encerramento
+- CORS habilitado no backend para a UI local (127.0.0.1:3030)
+
 ## 0.1.00 (2026-10-23)
 
 Bootstrap inicial do repositório PandaNews.

package/README.md

@@ -9,42 +9,35 @@ SaaS **local** (roda no navegador) para criação e automação de múltiplos bl
 - 100% local por padrão (SQLite + arquivos), com Supabase opcional
 - Agendamento automático por blog (APScheduler)
 
-## Instalação
+## Instalação e uso — um único comando
 
 CMD / MobaXterm:
 
 ```
-npx.cmd --yes --prefer-online @danhachuel/pandanews@latest install
-npx.cmd --yes --prefer-online @danhachuel/pandanews@latest
+npx.cmd --yes --prefer-online @danhachuel/pandanews
 ```
 
 Shell (PowerShell, Linux, macOS):
 
 ```
-npx --yes @danhachuel/pandanews@latest install
-npx --yes @danhachuel/pandanews@latest
+npx --yes @danhachuel/pandanews
 ```
 
-Requisitos: **Node.js >= 20**. Nenhum Python pré-instalado é necessário — o instalador provisiona um runtime Python portátil na primeira execução (`.runtime/` na raiz do pacote; sobrescreva com a variável de ambiente `PANDANEWS_HOME`).
+Na primeira execução o PandaNews instala **tudo junto, automaticamente**: runtime Python portátil, dependências do backend e banco de dados local (SQLite). Nenhum Python, pip ou outra dependência pré-instalada é necessária — apenas **Node.js >= 20**.
 
-## Status (versão 0.1.00)
-
-Versão inicial de **bootstrap**: estrutura do repositório, CLI (`pandanews install/start/build`) e workflow de publicação via GitHub Actions. O backend FastAPI e a UI React chegam na **0.2.00** (Fases 1 a 4 do plano de implementação — ver `CHANGELOG.md`).
-
-## Desenvolvimento
+Opcional — pré-instalar antes do primeiro uso:
 
 ```
-# Backend
-pip install -r backend/requirements.txt
-uvicorn backend.app.main:app --reload --port 8000
+npx.cmd --yes --prefer-online @danhachuel/pandanews install
+npx --yes @danhachuel/pandanews install
+```
 
-# Frontend
-cd frontend && npm install && npm run dev
+O runtime fica em `.runtime/` na raiz do pacote (sobrescreva com a variável de ambiente `PANDANEWS_HOME`).
 
-# CLI local
-node bin/cli.js install --skip-python-deps
-node bin/cli.js
-```
+## Status (versão 0.1.02)
+
+- `npx @danhachuel/pandanews` instala tudo junto (Python portátil + dependências + banco local) e sobe o backend em 127.0.0.1:8000 com página em 127.0.0.1:4030 — se a porta estiver ocupada, usa a seguinte automaticamente (4031, 4032, ...)
+- A UI React completa (Dashboard, Blogs, Notícias, Imagens, Automação, Configurações) e o pipeline de notícias chegam nas próximas versões (Fases 1 a 3 do plano — ver `CHANGELOG.md`)
 
 ## Regras do projeto
 

package/backend/__init__.py

@@ -0,0 +1 @@
+"""PandaNews — pacote backend (entrypoint: backend.app.main:app)."""

package/backend/app/main.py

@@ -1,11 +1,20 @@
 """PandaNews API — FastAPI.
 
-Fase 0 (0.1.00): aplicação mínima com endpoint de health.
-Fase 1: CRUD de blogs, configurações e router de LLM (NVIDIA NIM -> Google Gemini).
+Fase 0/1: aplicação mínima com endpoint de health e CORS liberado para a UI
+local (localhost/127.0.0.1 em qualquer porta — a UI usa porta dinâmica a partir
+de 4030). CRUD de blogs e configurações chegam na Fase 1.
 """
 from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
 
-app = FastAPI(title="PandaNews API", version="0.1.00")
+app = FastAPI(title="PandaNews API", version="0.1.2")
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origin_regex=r"^https?://(localhost|127\.0\.0\.1)(:\d+)?$",
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
 
 
 @app.get("/api/v1/health")

package/frontend/README.md

@@ -5,4 +5,4 @@ UI do PandaNews (React + Vite + Tailwind), inicializada na Fase 2 do plano de im
 - Páginas: Dashboard, Blogs, Notícias, Imagens, Automação, Configurações, Logs
 - Sidebar + topbar no padrão Leadmaster
 - 7 leis de usabilidade aplicadas (Fitts, Hick, Zeigarnik, Jakob, Gradiente de Meta, von Restorff, Miller)
-- Build: `npm run build` → `dist/` servido em 127.0.0.1:3030
+- Build: `npm run build` → `dist/` servido em 127.0.0.1:4030 (com fallback para 4031, 4032, ... se ocupada)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/pandanews",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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",

package/scripts/install.js

@@ -1,25 +1,32 @@
 // Instalador do runtime PandaNews.
 //
-// Fase 0 (0.1.00): detecta plataforma, cria a estrutura de pastas (data/, .runtime/)
-// e grava o marcador .runtime/.ready. O provisionamento completo de Python
-// portátil + venv + dependências chega na versão 0.2.00 (Fase 4 do plano).
-import { mkdirSync, writeFileSync } from 'node:fs';
+// Provisiona tudo em um único comando (padrão Thunderbolt):
+// 1. estrutura de pastas (data/, .runtime/)
+// 2. Python 3.12.7 portátil via python-build-standalone (sem Python pré-instalado)
+// 3. virtualenv em .runtime/venv
+// 4. dependências do backend (backend/requirements.txt)
+// 5. marcadores de estado (.runtime/.ready, .runtime/.python-ready)
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
 import { join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
 export const PKG_ROOT = join(__dirname, '..');
 
+const PYTHON_VERSION = '3.12.7';
+const PYTHON_RELEASE = '20241016';
+
 // Raiz de instalação: PANDANEWS_HOME sobrepõe o padrão (raiz do pacote instalado).
 export function resolveHome() {
   return process.env.PANDANEWS_HOME ? resolve(process.env.PANDANEWS_HOME) : PKG_ROOT;
 }
 
-// Detecta plataforma e arquitetura para o download de python-build-standalone (Fase 4).
+// Detecta plataforma e asset de python-build-standalone.
 export function detectPlatform() {
   const arch = process.arch === 'arm64' ? 'aarch64' : 'x86_64';
   if (process.platform === 'win32') {
-    return { os: 'windows', arch, asset: `${arch}-pc-windows-msvc-shared-install_only.zip` };
+    return { os: 'windows', arch, asset: `${arch}-pc-windows-msvc-shared-install_only.tar.gz` };
   }
   if (process.platform === 'darwin') {
     return { os: 'macos', arch, asset: `${arch}-apple-darwin-install_only.tar.gz` };
@@ -27,6 +34,61 @@ export function detectPlatform() {
   return { os: 'linux', arch, asset: `${arch}-unknown-linux-gnu-install_only.tar.gz` };
 }
 
+function pythonArchiveUrl(platform) {
+  const base = 'https://github.com/astral-sh/python-build-standalone/releases/download';
+  return `${base}/${PYTHON_RELEASE}/cpython-${PYTHON_VERSION}+${PYTHON_RELEASE}-${platform.asset}`;
+}
+
+function pythonBin(home) {
+  return process.platform === 'win32'
+    ? join(home, '.runtime', 'python', 'python.exe')
+    : join(home, '.runtime', 'python', 'bin', 'python3');
+}
+
+function venvBin(home) {
+  return process.platform === 'win32'
+    ? join(home, '.runtime', 'venv', 'Scripts', 'python.exe')
+    : join(home, '.runtime', 'venv', 'bin', 'python');
+}
+
+async function downloadPython(home, platform) {
+  const url = pythonArchiveUrl(platform);
+  const runtimeDir = join(home, '.runtime');
+  const downloadsDir = join(runtimeDir, 'downloads');
+  const archive = join(downloadsDir, `cpython-${PYTHON_VERSION}+${PYTHON_RELEASE}-${platform.asset}`);
+  mkdirSync(downloadsDir, { recursive: true });
+  console.log(`Baixando Python ${PYTHON_VERSION} portátil (${platform.os} ${platform.arch})...`);
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`Falha no download do Python (${res.status}): ${url}`);
+  const buf = Buffer.from(await res.arrayBuffer());
+  writeFileSync(archive, buf);
+  console.log(`Download concluído (${(buf.length / 1024 / 1024).toFixed(1)} MB). Extraindo...`);
+  const tar = spawnSync('tar', ['-xzf', archive, '-C', runtimeDir]);
+  if (tar.status !== 0) throw new Error('Falha ao extrair o Python portátil (tar).');
+  if (!existsSync(pythonBin(home))) {
+    throw new Error('Extração do Python concluída, mas o binário não foi encontrado.');
+  }
+  console.log(`Python ${PYTHON_VERSION} pronto em ${join(runtimeDir, 'python')}`);
+}
+
+function createVenv(home) {
+  console.log('Criando virtualenv...');
+  const venv = spawnSync(pythonBin(home), ['-m', 'venv', join(home, '.runtime', 'venv')], { stdio: 'inherit' });
+  if (venv.status !== 0) throw new Error('Falha ao criar o virtualenv.');
+  if (!existsSync(venvBin(home))) throw new Error('Virtualenv criado, mas o binário não foi encontrado.');
+}
+
+function installDeps(home) {
+  console.log('Instalando dependências do backend (pode levar alguns minutos)...');
+  const req = join(PKG_ROOT, 'backend', 'requirements.txt');
+  const pip = spawnSync(
+    venvBin(home),
+    ['-m', 'pip', 'install', '--disable-pip-version-check', '-r', req],
+    { stdio: 'inherit' },
+  );
+  if (pip.status !== 0) throw new Error('Falha ao instalar as dependências do backend.');
+}
+
 export async function runInstall({ skipPythonDeps = false } = {}) {
   const home = resolveHome();
   const platform = detectPlatform();
@@ -44,14 +106,27 @@ export async function runInstall({ skipPythonDeps = false } = {}) {
     mkdirSync(dir, { recursive: true });
   }
 
-  // Fase 4 (0.2.00): download de Python 3.12 portátil, venv e requirements.
   if (skipPythonDeps) {
     console.log('--skip-python-deps: instalação estrutural (uso em CI).');
+  } else if (existsSync(join(home, '.runtime', '.python-ready'))) {
+    console.log('Runtime Python já provisionado — nada a fazer.');
   } else {
-    console.log('Provisionamento de Python portátil e dependências: chega na versão 0.2.00 (Fase 4).');
+    if (!existsSync(pythonBin(home))) {
+      await downloadPython(home, platform);
+    } else {
+      console.log('Python portátil já presente.');
+    }
+    if (!existsSync(venvBin(home))) {
+      createVenv(home);
+    } else {
+      console.log('Virtualenv já presente.');
+    }
+    installDeps(home);
+    writeFileSync(join(home, '.runtime', '.python-ready'), new Date().toISOString());
+    console.log('Dependências instaladas. Runtime Python pronto.');
   }
 
   writeFileSync(join(home, '.runtime', '.ready'), new Date().toISOString());
-  console.log('Estrutura pronta. Runtime inicializado.');
+  console.log('Instalação concluída.');
   return home;
 }

package/scripts/start.js

@@ -1,23 +1,132 @@
-// Inicia o PandaNews: backend FastAPI (127.0.0.1:8000) + UI estática (127.0.0.1:3030).
+// Inicia o PandaNews: backend FastAPI (127.0.0.1:8000) + UI (127.0.0.1:4030+).
 //
-// Fase 0 (0.1.00): garante que o runtime esteja instalado e informa o status.
-// Fase 4 (0.2.00): sobe o uvicorn, serve frontend/dist e abre o navegador.
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { resolveHome, runInstall } from './install.js';
+// Fluxo de um único comando (padrão Thunderbolt): se o runtime não estiver
+// provisionado, executa o install completo (Python portátil + dependências)
+// antes de subir os servidores. A UI começa em PANDANEWS_UI_PORT (padrão 4030)
+// e, se a porta estiver ocupada, tenta automaticamente a seguinte (4031, ...).
+import { existsSync, readFileSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { createServer } from 'node:http';
+import { join, extname } from 'node:path';
+import { resolveHome, runInstall, PKG_ROOT } from './install.js';
+
+const BACKEND_PORT = Number(process.env.PANDANEWS_API_PORT || 8000);
+const UI_PORT_BASE = Number(process.env.PANDANEWS_UI_PORT || 4030);
+const UI_PORT_MAX_TRIES = 20;
+
+function venvBin(home) {
+  return process.platform === 'win32'
+    ? join(home, '.runtime', 'venv', 'Scripts', 'python.exe')
+    : join(home, '.runtime', 'venv', 'bin', 'python');
+}
+
+const MIME = {
+  '.html': 'text/html; charset=utf-8',
+  '.js': 'text/javascript; charset=utf-8',
+  '.css': 'text/css; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.svg': 'image/svg+xml',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.ico': 'image/x-icon',
+};
+
+function placeholderPage() {
+  return `<!DOCTYPE html>
+<html lang="pt-BR">
+<head><meta charset="utf-8"><title>PandaNews</title></head>
+<body style="font-family: Inter, system-ui, sans-serif; background: #0b1220; color: #e6edf3; display: flex; min-height: 100vh; align-items: center; justify-content: center;">
+  <div style="text-align: center;">
+    <h1 style="font-size: 3rem; margin: 0;">🐼 PandaNews</h1>
+    <p style="color: #9aa7b5;">Backend ativo em <a style="color: #22c55e;" href="http://127.0.0.1:8000/api/v1/health">127.0.0.1:8000</a></p>
+    <p style="color: #9aa7b5;">A UI React completa chega na versão 0.2.00 (Fases 1 a 3 do plano).</p>
+  </div>
+</body>
+</html>`;
+}
+
+let uiServer = null;
+
+function createUiServer() {
+  const distDir = join(PKG_ROOT, 'frontend', 'dist');
+  return createServer((req, res) => {
+    const url = req.url.split('?')[0];
+    const filePath = join(distDir, url === '/' ? 'index.html' : url.slice(1));
+    if (!existsSync(filePath)) {
+      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+      res.end(placeholderPage());
+      return;
+    }
+    res.writeHead(200, { 'Content-Type': MIME[extname(filePath)] || 'application/octet-stream' });
+    res.end(readFileSync(filePath));
+  });
+}
+
+function listenUi(port, attempt) {
+  if (attempt > UI_PORT_MAX_TRIES) {
+    console.error(`Nenhuma porta livre entre ${UI_PORT_BASE} e ${UI_PORT_BASE + UI_PORT_MAX_TRIES - 1}.`);
+    console.error('Encerre algum processo que as ocupe ou defina PANDANEWS_UI_PORT.');
+    process.exit(1);
+  }
+  const server = createUiServer();
+  server.once('error', (err) => {
+    if (err && err.code === 'EADDRINUSE') {
+      console.log(`Porta ${port} ocupada — tentando ${port + 1}...`);
+      listenUi(port + 1, attempt + 1);
+    } else {
+      console.error(`Erro no servidor de UI: ${err && err.message}`);
+      process.exit(1);
+    }
+  });
+  server.listen(port, '127.0.0.1', () => {
+    uiServer = server;
+    console.log(`PandaNews ativo em http://127.0.0.1:${port}`);
+    console.log('Pressione Ctrl+C para encerrar.');
+    openBrowser(`http://127.0.0.1:${port}`);
+  });
+}
+
+async function openBrowser(url) {
+  try {
+    const { default: open } = await import('open');
+    await open(url);
+  } catch {
+    /* ambiente sem navegador (ex.: CI) */
+  }
+}
 
 export async function runStart() {
   const home = resolveHome();
-  const readyMarker = join(home, '.runtime', '.ready');
-
-  if (!existsSync(readyMarker)) {
-    console.log('Runtime não encontrado — executando install...');
+  if (!existsSync(join(home, '.runtime', '.ready'))) {
+    console.log('Runtime não encontrado — instalando tudo (Python portátil + dependências)...');
     await runInstall({});
   }
+  if (!existsSync(venvBin(home))) {
+    console.log('Runtime Python ausente. Execute o comando com `install` primeiro:');
+    console.log('  npx --yes @danhachuel/pandanews install');
+    process.exitCode = 1;
+    return;
+  }
+
+  console.log(`Iniciando backend FastAPI em http://127.0.0.1:${BACKEND_PORT} ...`);
+  const uvicorn = spawn(
+    venvBin(home),
+    ['-m', 'uvicorn', 'backend.app.main:app', '--host', '127.0.0.1', '--port', String(BACKEND_PORT)],
+    { cwd: PKG_ROOT, stdio: 'inherit' },
+  );
+  uvicorn.on('exit', (code) => {
+    if (code !== 0 && code !== null) {
+      console.error(`Backend encerrou com código ${code}.`);
+      process.exit(code ?? 1);
+    }
+  });
+
+  listenUi(UI_PORT_BASE, 1);
 
-  console.log('');
-  console.log('PandaNews 0.1.00 — versão inicial de bootstrap.');
-  console.log('O backend FastAPI (127.0.0.1:8000) e a UI (127.0.0.1:3030) serão');
-  console.log('servidos por este comando a partir da versão 0.2.00 (Fases 1 a 4 do plano).');
-  console.log(`Raiz do runtime: ${home}`);
+  process.on('exit', () => {
+    if (uiServer) uiServer.close();
+    uvicorn.kill();
+  });
+  process.on('SIGINT', () => process.exit(0));
+  process.on('SIGTERM', () => process.exit(0));
 }