Files
autoficher/app/settings.py
omar 9294474066 feat: nucleo nuevo: cliente API, calendario laboral, planificador y jitter
Timenet recorta el tiempo a la ventana teorica del horario:

    trabajado = min(salida, fin_teorico) - max(entrada, inicio_teorico)

Verificado sobre 6 meses (104 dias laborables, 376 fichajes). La API guarda dos
horas por fichaje: HR (la que fichas) y H (la que cuenta). De 376 fichajes, 136
llevaban ajuste: todos salidas, todos recortados hacia atras. Ninguna entrada
ajustada jamas. Resultado: una entrada tardia se debita al minuto y una salida
tardia no acredita nada, asi que el jitter aleatorio positivo que habia perdia
unos 3,2 min/dia (-776 min acumulados, casi 13 horas).

Y acabar el mes en positivo es imposible: 0 dias con saldo positivo en 108, y
timeExtraHours=false en todos los tipos de jornada. El objetivo es 0 clavado.

- timenet_api: cliente limpio. Documenta que Tn-D y dStr son obligatorias (sin
  ellas el servidor responde 403 hasta en endpoints publicos).
- schedule: calendario laboral desde cp/calendar. Festivos, vacaciones y tramos
  horarios los da Timenet, no hace falta adivinarlos.
- planner + jitter: entradas siempre ANTES de la hora, salidas siempre DESPUES,
  con costumbre que deriva lenta y cola larga hacia el lado seguro. Invariantes
  que fallan en duro si una entrada se planifica tarde.
- jitter_geo: las coordenadas del historico son identicas al sexto decimal en
  los 376 fichajes; ahora se desplazan dentro de un disco.
- store: SQLite con plan diario, overrides, auditoria y estado del drift.
- settings: config sin el acoplamiento a argparse del config_parser original.

tools/dryrun.py simula el año entero: saldo +0 en 226 dias laborables, con
~3,5 min/dia de presencia extra.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-24 18:51:33 +02:00

67 lines
2.5 KiB
Python

"""Carga de config.json sin depender de argparse.
El ``config_parser`` original invoca ``ArgParser().parse()`` en tiempo de import, lo
que obliga a que haya argumentos de linea de comandos validos. El daemon y las
herramientas necesitan leer la configuracion sin eso.
"""
from __future__ import annotations
import json
import os
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
DEFAULT_CONFIG = os.path.join(ROOT, "config.json")
DEFAULTS = {
"api_url": "https://timenet-wcp.gpisoftware.com/api/",
"timezone": "Europe/Madrid",
"jitter": {
# margen, en segundos, con el que se ficha respecto de la hora teorica.
# Entradas ANTES (Timenet no acredita nada fuera de la ventana, pero si
# debita las entradas tardias). Salidas DESPUES.
# perfil "equilibrado": saldo 0 con ~3,6 min/dia de presencia extra.
# Mas holgado (40/150/30/130) = mas seguro pero ~5,7 min/dia.
# Mas ajustado (20/70/15/45) = ~2,7 min/dia pero solo 15s de colchon.
"entry_before_min": 30,
"entry_before_max": 100,
"exit_after_min": 20,
"exit_after_max": 70,
# deriva lenta de la hora habitual, para no parecer un dado nuevo cada dia
"drift_sigma": 25,
"drift_clamp": 60,
# margen de seguridad: nunca fichar una entrada a menos de X s de la hora
"entry_guard": 20,
},
"geo_jitter_meters": 12.0,
"telegram": {},
}
def _merge(base: dict, over: dict) -> dict:
out = dict(base)
for k, v in (over or {}).items():
out[k] = _merge(base[k], v) if isinstance(v, dict) and isinstance(base.get(k), dict) else v
return out
def load(path: str | None = None) -> dict:
path = path or os.environ.get("AUTOFICHER_CONFIG") or DEFAULT_CONFIG
if not os.path.exists(path):
raise FileNotFoundError(f"No se encuentra el archivo de configuracion: {path}")
with open(path, encoding="utf-8") as f:
cfg = json.load(f)
if not isinstance(cfg, dict):
raise ValueError("config.json no contiene un objeto JSON")
cfg = _merge(DEFAULTS, cfg)
for req in ("api_url", "user"):
if not cfg.get(req):
raise ValueError(f"Falta '{req}' en {path}")
return cfg
def pin(cfg: dict | None = None) -> str:
"""PIN desde el entorno, la config o por teclado. Nunca se escribe a disco."""
import getpass
p = os.environ.get("TIMENET_PIN") or (cfg or {}).get("pin")
return str(p) if p else getpass.getpass("PIN de Timenet: ")