feat(sat): reporte diario de errores SAT por proxy

- Agrega tabla sat_proxy_errors con proxy_usado, error_code, stage, message.
- sat-client.service.ts expone proxyInfo usado en cada conexión SAT.
- sat.service.ts registra errores de bloqueo/devolución del SAT en sat_proxy_errors
  y guarda proxyUsed en sat_sync_jobs.
- Nuevo job sat-proxy-report.job.ts: cron 8 AM CDMX, envía email a ADMIN_EMAIL
  con errores de las últimas 24h agrupados por proxy/error_code.
- Template de email sat-proxy-report.ts y método sendSatProxyReport.
- Registra el cron en src/index.ts.
- Actualiza docs/SAT-SYNC-IMPLEMENTATION.md.
This commit is contained in:
Horux Dev
2026-08-03 14:29:54 +00:00
parent b43c9f334a
commit a008659eda
10 changed files with 274 additions and 7 deletions

View File

@@ -0,0 +1,2 @@
-- Agrega proxy_used a sat_sync_jobs para diagnosticar bloqueos por IP
ALTER TABLE "sat_sync_jobs" ADD COLUMN IF NOT EXISTS "proxy_used" VARCHAR(255);

View File

@@ -0,0 +1,13 @@
-- Tabla de errores SAT por proxy para reportes diarios
CREATE TABLE IF NOT EXISTS "sat_proxy_errors" (
"id" TEXT PRIMARY KEY DEFAULT gen_random_uuid(),
"job_id" TEXT NOT NULL REFERENCES "sat_sync_jobs"("id") ON DELETE CASCADE,
"proxy_used" VARCHAR(255),
"error_code" VARCHAR(50),
"stage" VARCHAR(255),
"message" TEXT,
"created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP
);
CREATE INDEX IF NOT EXISTS "sat_proxy_errors_created_at_idx" ON "sat_proxy_errors"("created_at");
CREATE INDEX IF NOT EXISTS "sat_proxy_errors_proxy_used_created_at_idx" ON "sat_proxy_errors"("proxy_used", "created_at");

View File

@@ -677,8 +677,12 @@ model SatSyncJob {
// usuario (botón UI). Cambia la política de retry: 2 intentos vs 3 del
// bootstrap puro. Daily/incremental ignoran este campo.
isCustomRange Boolean @default(false) @map("is_custom_range")
// Proxy usado en el último request SAT que falló (host:port). Ayuda a diagnosticar
// bloqueos por IP y a generar reportes diarios de errores por proxy.
proxyUsed String? @map("proxy_used") @db.VarChar(255)
tenant Tenant @relation(fields: [tenantId], references: [id], onDelete: Cascade)
proxyErrors SatProxyError[]
@@index([tenantId])
@@index([status])
@@ -686,6 +690,24 @@ model SatSyncJob {
@@map("sat_sync_jobs")
}
// Errores de bloqueo/devolución del SAT por proxy.
// Permite reportes diarios de cuántos 404/500X/etc. ocurrieron en cada IP.
model SatProxyError {
id String @id @default(uuid())
jobId String @map("job_id")
proxyUsed String? @map("proxy_used") @db.VarChar(255)
errorCode String? @map("error_code") @db.VarChar(50)
stage String? @map("stage") @db.VarChar(255)
message String? @map("message")
createdAt DateTime @default(now()) @map("created_at")
job SatSyncJob @relation(fields: [jobId], references: [id], onDelete: Cascade)
@@index([createdAt])
@@index([proxyUsed, createdAt])
@@map("sat_proxy_errors")
}
enum SatSyncType {
initial
daily