Initial commit — Pedrito Hechakuaa v0

Bot de Telegram para monitoreo de notificaciones judiciales del PJ Paraguay.
Multi-tenant con onboarding conversacional, audit log, y polling automático.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

OBSERVATIONS.md

@@ -0,0 +1,34 @@
+# OBSERVATIONS.md — Hallazgos del desarrollo
+
+Hallazgos técnicos y decisiones ad-hoc tomadas durante el desarrollo.
+Actualizar cada vez que se descubra algo relevante sobre el sistema del PJ
+o sobre el comportamiento del bot.
+
+---
+
+## Sistema judicial (apps.csj.gov.py)
+
+### Estructura del response de notificaciones — PRIMER RUN REAL 2026-05-22
+**Fecha**: 2026-05-22
+
+`CantidadNotificacionesPorRecibir` devolvió `2` (entero directo ✅).
+
+`Notificaciones/PorRecibir` devolvió lista vacía (`total: 0, nuevas: 0`)
+a pesar de que el contador dijo 2. Comportamiento posible:
+- El endpoint de cantidad cuenta algo diferente (notificaciones ya acusadas parcialmente, otro estado)
+- El formato del response de la lista no coincide con ninguna de las claves esperadas (`items`, `data`, `notificaciones`) → el array llega bajo otra clave que `csj_client.py` no reconoce y cae al fallback de lista vacía
+
+**Acción pendiente**: inspeccionar el response crudo de `PorRecibir` con LOG_LEVEL=DEBUG
+para ver la estructura exacta del JSON y ajustar el parsing en `csj_client.py`.
+
+---
+
+## Bot de Telegram
+
+*(agregar hallazgos acá)*
+
+---
+
+## Deuda técnica activa
+
+Ver `TECH_DEBT.md`.