Config y perfiles¶

Configuración Spring del backend: archivos application*.yml, perfiles, variables de entorno y bloque AFIP. Todo sale de src/main/resources/application*.yml (+ el application-realdb.yml de test). Para la persistencia ver Persistencia; para el cliente AFIP, Cliente AFIP.

Perfiles¶

Perfil por defecto: spring.profiles.default: dev. Para activar otro: --spring.profiles.active=prod o SPRING_PROFILES_ACTIVE=prod.

application.yml (base)¶

spring:
  application:
    name: tifactura-spring
  profiles:
    default: dev
  datasource:
    hikari:
      maximum-pool-size: ${DB_POOL_MAX:20}
      connection-timeout: ${DB_CONN_TIMEOUT_MS:30000}
      leak-detection-threshold: 60000
  quartz:
    wait-for-jobs-to-complete-on-shutdown: true
  jpa:
    hibernate:
      ddl-auto: none
      naming:
        physical-strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
    open-in-view: false
    database-platform: com.tipre.tifacturaonlinemanager.action.db.SQLServerDialect

cxf:
  path: /TiFacturaOnlineManagerWS

cockpit:
  auth:
    user: ${COCKPIT_USER:}
    password: ${COCKPIT_PASS:}
  admin-secret: ${COCKPIT_ADMIN_SECRET:}
  revalidar-arca-al-guardar: ${COCKPIT_REVALIDAR_ARCA:false}
  runner-enabled: ${COCKPIT_RUNNER_ENABLED:false}
  jobs-alerta-umbral: 3

afip:
  mode: HOMOLOGACION
  wsaa-url: https://wsaahomo.afip.gov.ar/ws/services/LoginCms
  wsfe-url: https://wswhomo.afip.gob.ar/wsfev1/service.asmx
  service: wsfe
  dstdn: cn=wsaahomo,o=afip,c=ar,serialNumber=CUIT 33693450239
  ticket-time-ms: 43200000      # 12h
  tls-insecure: true
  cuit: ${AFIP_CUIT:}
  comprobantes-por-request: 1
  connect-timeout-ms: 15000
  read-timeout-ms: 60000        # WSFE (FECAESolicitar y consultas)
  wsaa-read-timeout-ms: 30000   # WSAA (LoginCms)
  retry:
    max-attempts: ${AFIP_RETRY_MAX_ATTEMPTS:1}
    backoff-ms: ${AFIP_RETRY_BACKOFF_MS:500}

logging:
  level:
    com.tipre.tifacturaonlinemanager: INFO

Pool JDBC (HikariCP)¶

El pool ahora es explícito (hardening F1). El default de Hikari era 10 conexiones; con 10 workers de Quartz, las emisiones V2 (cada una puede tener 2 conexiones en vuelo por el REQUIRES_NEW del persist-before-emit) y el polling del cockpit, 10 se agotan sin que haya ningún bug. Sube a 20 por default.

Shutdown ordenado¶

spring.quartz.wait-for-jobs-to-complete-on-shutdown: true (hardening F1): al frenar el servicio (NSSM stop / SIGTERM), Spring espera a que los jobs Quartz en vuelo terminen antes de bajar el contexto. Matar la reconciliación de NC o un informe CAEA a mitad de camino es recuperable (persist-before-emit) pero evitable.

nssm set TipreTiFactura AppStopMethodConsole 45000

application-dev.yml¶

spring:
  datasource:
    url: jdbc:sqlserver://localhost:1433;databaseName=tifacturaonline;encrypt=true;trustServerCertificate=true
    username: ${DB_USER:sa}
    password: ${DB_PASS:}
    driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver
logging:
  level:
    com.tipre.tifacturaonlinemanager: DEBUG

# DEV/test: el runner de validación del cockpit está ACTIVO (es el ambiente de pruebas).
cockpit:
  runner-enabled: true
  # Credenciales de dev para el cockpit. Cambiar en prod por env (COCKPIT_USER / COCKPIT_PASS).
  auth:
    user: admin
    password: changeme

AFIP queda en HOMOLOGACION (heredado del base). DB local: usuario default sa, password vacío por default. El runner del cockpit queda activo (cockpit.runner-enabled: true). Las credenciales de auth del cockpit traen los defaults de dev admin / changeme (cambiar en prod por env var).

application-prod.yml¶

spring:
  datasource:
    url: jdbc:sqlserver://${DB_HOST}:${DB_PORT:1433};databaseName=${DB_NAME};encrypt=true;trustServerCertificate=true
    username: ${DB_USER}
    password: ${DB_PASS}
    driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver

afip:
  mode: PRODUCCION
  wsaa-url: https://wsaa.afip.gov.ar/ws/services/LoginCms
  wsfe-url: https://servicios1.afip.gov.ar/wsfev1/service.asmx
  dstdn: cn=wsaa,o=afip,c=ar,serialNumber=CUIT 33693450239

logging:
  level:
    com.tipre.tifacturaonlinemanager: INFO

# PROD: el runner de validación queda DESHABILITADO (la página es solo monitoreo, no emite nada).
cockpit:
  runner-enabled: false

En prod todos los hosts y secretos de DB son env vars sin default → si faltan, la app no levanta (intencional: nada hardcodeado). El runner del cockpit queda apagado (cockpit.runner-enabled: false): aunque alguien pegue a /api/cockpit/test/* por URL, esos endpoints responden 403.

Variables de entorno¶

Config AFIP (afip.*)¶

Estas properties las consume AfipClientConfig (vía @Value con los mismos defaults). El bloque base es HOMOLOGACION; application-prod.yml lo sobreescribe a PRODUCCION.

CXF (SOAP)¶

cxf.path: /TiFacturaOnlineManagerWS monta el CXFServlet. CxfSoapConfig publica 3 endpoints bajo ese path, cada uno sirviendo el WSDL baseline de producción:

Detalle en API SOAP.

Cockpit¶

cockpit.auth.user / cockpit.auth.password (env COCKPIT_USER / COCKPIT_PASS) son las credenciales de autenticación del cockpit (D5). Las consume SecurityConfig, que arma un SecurityFilterChain con un InMemoryUserDetailsManager (rol COCKPIT, password BCrypt): todo lo que cae bajo /api/cockpit/**, /cockpit, /cockpit-test, /cockpit-prod y /cockpit.html queda autenticado (HTTP Basic para la API, form login para la UI); los endpoints de facturación (/TiFacturaOnlineManagerWS/**, /ws/**) quedan abiertos. Si user/pass vienen vacíos se usan los defaults de dev (admin / changeme) y se loguea un WARN al arrancar — en prod hay que setearlos por env.

cockpit.admin-secret (env COCKPIT_ADMIN_SECRET) es un candado extra sobre el ABM de SucPosPV, que opera vía header X-Cockpit-Secret dentro de la ruta ya autenticada: Spring Security verifica user/pass primero, y recién después el controller chequea el secret. Es fail-closed: si no hay secret configurado, el ABM responde deshabilitado. cockpit.revalidar-arca-al-guardar (env COCKPIT_REVALIDAR_ARCA, default false) controla si se revalidan los PV contra AFIP al guardar. cockpit.runner-enabled (env COCKPIT_RUNNER_ENABLED, default false) habilita el runner de validación (/api/cockpit/test/*): también es fail-closed (si false, esos endpoints responden 403), activo en dev y apagado en prod. cockpit.jobs-alerta-umbral (default 3) es el umbral de la alerta roja de jobs: un job entra en alerta cuando sus últimas N ejecuciones consecutivas terminaron en ERROR (bitácora JobEjecucion). La consumen el cockpit y sus endpoints; el lado del job en Jobs Quartz. Ver Cockpit.

Logging¶

Configurado en src/main/resources/logback-spring.xml (sobre los defaults de Spring Boot). Variable LOG_DIR (default logs).

Niveles del paquete com.tipre.tifacturaonlinemanager: INFO en base/prod, DEBUG en dev.

Por dónde seguir¶

• Backend — stack y build.
• Persistencia — datasource y dialecto.
• Cliente AFIP — cómo se usa el bloque afip.*.
• Setup de desarrollo — levantar con el perfil dev.