From 4716d02ef99ed38f338afeb9f8626aec9d08364d Mon Sep 17 00:00:00 2001
From: cheveguerra <cheveguerra@users.noreply.github.com>
Date: Fri, 24 Jul 2026 15:35:28 +0000
Subject: [PATCH] Update README and script docs with credentials.json format
 specifications

---
 README.md | 43 +++++++++++++++++++++++++++++++++++++++++++
 index.py  | 43 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 86 insertions(+)

diff --git a/README.md b/README.md
index 503d6b9..c59d3bb 100755
--- a/README.md
+++ b/README.md
@@ -54,6 +54,49 @@ Consulta los estados una sola vez, genera `status.html` and finaliza. Ideal para
 
 ---
 
+## 🔑 Formato de Configuración (`credentials.json`)
+
+El archivo `credentials.json` debe colocarse junto al ejecutable o script y soporta dos formatos:
+
+### Formato A (Formato por objeto con puerto, exclusiones y navegador - RECOMENDADO):
+```json
+{
+  "port": 8080,
+  "exclude": ["1071", "1171", "1215"],  // Lista de sucursales a ignorar (ID, número o nombre)
+  "open_browser": true,                  // true para abrir navegador al iniciar (defecto en GUI)
+  "accounts": [
+    {
+      "label": "2020",
+      "username": "TuUsuario2020",
+      "password": "TuPassword2020"
+    },
+    {
+      "label": "2019",
+      "username": "TuUsuario2019",
+      "password": "TuPassword2019"
+    }
+  ]
+}
+```
+
+### Formato B (Formato original de lista - Puerto por defecto 8080):
+```json
+[
+  {
+    "label": "2020",
+    "username": "TuUsuario2020",
+    "password": "TuPassword2020"
+  },
+  {
+    "label": "2019",
+    "username": "TuUsuario2019",
+    "password": "TuPassword2019"
+  }
+]
+```
+
+---
+
 ## 🔒 Robustez y Resiliencia Implementada
 
 * **Motor Híbrido Dinámico (27 + 7):** En cada ciclo de 30s se procesan 27 sucursales del turno ordinario (ordenadas secuencialmente por antigüedad) + hasta 7 de alta frecuencia (desarmadas/alarmadas/fallos), previniendo rate-limits.
diff --git a/index.py b/index.py
index ecad318..dc8445a 100755
--- a/index.py
+++ b/index.py
@@ -330,6 +330,49 @@ Consulta los estados una sola vez, genera `status.html` y finaliza. Ideal para a
 
 ---
 
+## 🔑 Formato de Configuración (`credentials.json`)
+
+El archivo `credentials.json` debe colocarse junto al ejecutable o script y soporta dos formatos:
+
+### Formato A (Formato por objeto con puerto, exclusiones y navegador - RECOMENDADO):
+```json
+{{
+  "port": 8080,
+  "exclude": ["1071", "1171", "1215"],  // Lista de sucursales a ignorar (ID, número o nombre)
+  "open_browser": true,                  // true para abrir navegador al iniciar (defecto en GUI)
+  "accounts": [
+    {{
+      "label": "2020",
+      "username": "TuUsuario2020",
+      "password": "TuPassword2020"
+    }},
+    {{
+      "label": "2019",
+      "username": "TuUsuario2019",
+      "password": "TuPassword2019"
+    }}
+  ]
+}}
+```
+
+### Formato B (Formato original de lista - Puerto por defecto 8080):
+```json
+[
+  {{
+    "label": "2020",
+    "username": "TuUsuario2020",
+    "password": "TuPassword2020"
+  }},
+  {{
+    "label": "2019",
+    "username": "TuUsuario2019",
+    "password": "TuPassword2019"
+  }}
+]
+```
+
+---
+
 ## 🔒 Robustez y Resiliencia Implementada
 
 * **Motor Híbrido Dinámico (27 + 7):** En cada ciclo de 30s se procesan 27 sucursales del turno ordinario (ordenadas secuencialmente por antigüedad) + hasta 7 de alta frecuencia (desarmadas/alarmadas/fallos), previniendo rate-limits.