From 77985ff57b59d487549c19d339eb16f351ad7a26 Mon Sep 17 00:00:00 2001
From: mgonzalez <linkedcorp.net@gmail.com>
Date: Fri, 5 Jun 2026 12:19:12 -0500
Subject: [PATCH] =?UTF-8?q?docs:=20advertencia=200.0.0.0=20vs=20127.0.0.1?=
 =?UTF-8?q?=20=E2=80=94=20502=20Bad=20Gateway=20si=20queda=20en=20loopback?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 PRODUCCION.md | 5 ++++-
 PROMPT_IA.md  | 4 +++-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/PRODUCCION.md b/PRODUCCION.md
index 7685fc2..efedfc9 100644
--- a/PRODUCCION.md
+++ b/PRODUCCION.md
@@ -31,7 +31,10 @@
 ## Servicio systemd
 
 - Servicio: `pflores-web.service`
-- Puerto interno: `127.0.0.1:8081`
+- Puerto: `0.0.0.0:8081`
+
+> ⚠ **El servicio DEBE escuchar en `0.0.0.0:8081`**, no en `127.0.0.1:8081`.
+> NPM viene de una IP externa y no puede alcanzar el loopback. Si queda en `127.0.0.1` el resultado es **502 Bad Gateway**.
 
 ```bash
 sudo systemctl status pflores-web
diff --git a/PROMPT_IA.md b/PROMPT_IA.md
index 0950736..1db723a 100644
--- a/PROMPT_IA.md
+++ b/PROMPT_IA.md
@@ -788,9 +788,11 @@ echo "1.0.1" > VERSION
 - `deploy` tiene sudo NOPASSWD
 - Ruta app: `/opt/apps/pflores.linkedcorp.net`
 - Servicio systemd: `pflores-web.service`
-- Puerto interno: `127.0.0.1:8081`
+- Puerto: `0.0.0.0:8081`
 - NPM proxy: `pflores.linkedcorp.net` → `192.168.222.3:8081`
 
+> ⚠ El servicio **debe** escuchar en `0.0.0.0:8081`, no en `127.0.0.1`. NPM llega desde fuera del loopback — si queda en `127.0.0.1` el resultado es **502 Bad Gateway**.
+
 Credenciales SSH: ver `LOCAL_DEPLOY_CONTEXT.md`
 
 ### Estructura en producción