@danhachuel/pandanews 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 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)

package/README.md

@@ -34,9 +34,9 @@ npx --yes @danhachuel/pandanews install
 
 O runtime fica em `.runtime/` na raiz do pacote (sobrescreva com a variável de ambiente `PANDANEWS_HOME`).
 
-## Status (versão 0.1.01)
+## 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:3030
+- `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/app/main.py

@@ -1,16 +1,17 @@
 """PandaNews API — FastAPI.
 
 Fase 0/1: aplicação mínima com endpoint de health e CORS liberado para a UI
-local (127.0.0.1:3030). CRUD de blogs e configurações chegam na Fase 1.
+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.1")
+app = FastAPI(title="PandaNews API", version="0.1.2")
 
 app.add_middleware(
     CORSMiddleware,
-    allow_origins=["http://localhost:3030", "http://127.0.0.1:3030"],
+    allow_origin_regex=r"^https?://(localhost|127\.0\.0\.1)(:\d+)?$",
     allow_methods=["*"],
     allow_headers=["*"],
 )

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.1",
+  "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/start.js

@@ -1,8 +1,9 @@
-// Inicia o PandaNews: backend FastAPI (127.0.0.1:8000) + UI (127.0.0.1:3030).
+// Inicia o PandaNews: backend FastAPI (127.0.0.1:8000) + UI (127.0.0.1:4030+).
 //
 // 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. Ao final, abre o navegador.
+// 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';
@@ -10,7 +11,8 @@ 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 = Number(process.env.PANDANEWS_UI_PORT || 3030);
+const UI_PORT_BASE = Number(process.env.PANDANEWS_UI_PORT || 4030);
+const UI_PORT_MAX_TRIES = 20;
 
 function venvBin(home) {
   return process.platform === 'win32'
@@ -43,9 +45,11 @@ function placeholderPage() {
 </html>`;
 }
 
-function serveUi(onReady) {
+let uiServer = null;
+
+function createUiServer() {
   const distDir = join(PKG_ROOT, 'frontend', 'dist');
-  const server = createServer((req, res) => {
+  return createServer((req, res) => {
     const url = req.url.split('?')[0];
     const filePath = join(distDir, url === '/' ? 'index.html' : url.slice(1));
     if (!existsSync(filePath)) {
@@ -56,16 +60,30 @@ function serveUi(onReady) {
     res.writeHead(200, { 'Content-Type': MIME[extname(filePath)] || 'application/octet-stream' });
     res.end(readFileSync(filePath));
   });
-  server.on('error', (err) => {
+}
+
+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.error(`A porta ${UI_PORT} já está em uso. Encerre o processo que a ocupa ou defina PANDANEWS_UI_PORT.`);
+      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);
     }
-    process.exit(1);
   });
-  server.listen(UI_PORT, '127.0.0.1', onReady);
-  return server;
+  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) {
@@ -103,14 +121,10 @@ export async function runStart() {
     }
   });
 
-  const server = serveUi(() => {
-    console.log(`PandaNews ativo em http://127.0.0.1:${UI_PORT}`);
-    console.log('Pressione Ctrl+C para encerrar.');
-    openBrowser(`http://127.0.0.1:${UI_PORT}`);
-  });
+  listenUi(UI_PORT_BASE, 1);
 
   process.on('exit', () => {
-    server.close();
+    if (uiServer) uiServer.close();
     uvicorn.kill();
   });
   process.on('SIGINT', () => process.exit(0));