fase 3.5: licenciamiento por plan (clave firmada, planes basico/profesional/enterprise/custom, modulos incluidos y limites de usuarios/sucursales/citas/almacenamiento, modo aviso o bloqueo, panel de licencia) + API keys gestionables con alcances y revocacion (arregla la API publica que estaba rota) + webhooks salientes firmados con outbox, reintentos y bitacora; herramientas de vendedor y docs
This commit is contained in:
7
odoo-addons/skeen_plataforma/models/__init__.py
Normal file
7
odoo-addons/skeen_plataforma/models/__init__.py
Normal file
@@ -0,0 +1,7 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
|
||||
from . import ir_http
|
||||
from . import api_key
|
||||
from . import webhook
|
||||
from . import limites
|
||||
from . import eventos
|
||||
168
odoo-addons/skeen_plataforma/models/api_key.py
Normal file
168
odoo-addons/skeen_plataforma/models/api_key.py
Normal file
@@ -0,0 +1,168 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""Claves de API de terceros (`skeen.api.key`).
|
||||
|
||||
La clave se muestra UNA sola vez al crearla: solo se guarda su hash SHA-256 y
|
||||
un prefijo visible para identificarla. La comparación es en tiempo constante.
|
||||
"""
|
||||
|
||||
import hashlib
|
||||
import hmac
|
||||
import json
|
||||
import secrets
|
||||
|
||||
from odoo import api, fields, models
|
||||
from odoo.exceptions import ValidationError
|
||||
|
||||
# Alcances disponibles (vacío = todos).
|
||||
SCOPES = [
|
||||
('citas.read', 'Consultar citas y disponibilidad'),
|
||||
('citas.write', 'Crear y cancelar citas'),
|
||||
('pacientes.read', 'Consultar pacientes y saldos'),
|
||||
('servicios.read', 'Consultar el catálogo de servicios'),
|
||||
('monedero.write', 'Redimir puntos del monedero'),
|
||||
]
|
||||
SCOPE_KEYS = tuple(k for k, _l in SCOPES)
|
||||
SCOPE_LABEL = dict(SCOPES)
|
||||
|
||||
PREFIJO_LARGO = 14 # caracteres visibles de la clave
|
||||
|
||||
|
||||
def hash_clave(raw):
|
||||
return hashlib.sha256((raw or '').encode('utf-8')).hexdigest()
|
||||
|
||||
|
||||
class SkeenApiKey(models.Model):
|
||||
_name = 'skeen.api.key'
|
||||
_description = 'Clave de API de terceros'
|
||||
_order = 'create_date desc, id desc'
|
||||
|
||||
name = fields.Char(string='Nombre', required=True)
|
||||
prefijo = fields.Char(string='Prefijo visible', required=True, index=True)
|
||||
hash = fields.Char(string='Hash', required=True)
|
||||
activo = fields.Boolean(string='Activa', default=True)
|
||||
scopes = fields.Char(string='Alcances', default='[]',
|
||||
help='Lista JSON de alcances. Vacío = todos.')
|
||||
vence = fields.Date(string='Vence')
|
||||
ultimo_uso = fields.Datetime(string='Último uso')
|
||||
usos = fields.Integer(string='Usos', default=0)
|
||||
notas = fields.Text(string='Notas')
|
||||
creado_por_login = fields.Char(string='Creada por')
|
||||
revocada_at = fields.Datetime(string='Revocada el')
|
||||
revocada_por = fields.Char(string='Revocada por')
|
||||
|
||||
_sql_constraints = [
|
||||
('hash_uniq', 'unique(hash)', 'Ya existe una clave de API con ese hash.'),
|
||||
]
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
@api.model
|
||||
def generar(self, vals, login=''):
|
||||
"""Crea una clave y devuelve (record, clave_en_claro).
|
||||
|
||||
La clave en claro solo se devuelve aquí; no se persiste.
|
||||
"""
|
||||
raw = 'sk_' + secrets.token_urlsafe(32)
|
||||
record = self.create({
|
||||
'name': vals.get('name') or 'Clave de API',
|
||||
'prefijo': raw[:PREFIJO_LARGO],
|
||||
'hash': hash_clave(raw),
|
||||
'scopes': json.dumps(self._normalizar_scopes(vals.get('scopes') or [])),
|
||||
'vence': vals.get('vence') or False,
|
||||
'notas': vals.get('notas') or '',
|
||||
'creado_por_login': login or '',
|
||||
'activo': True,
|
||||
})
|
||||
return record, raw
|
||||
|
||||
@api.model
|
||||
def _normalizar_scopes(self, scopes):
|
||||
if not isinstance(scopes, (list, tuple)):
|
||||
return []
|
||||
limpios = []
|
||||
for s in scopes:
|
||||
s = str(s or '').strip()
|
||||
if s and s in SCOPE_KEYS and s not in limpios:
|
||||
limpios.append(s)
|
||||
return limpios
|
||||
|
||||
def scopes_list(self):
|
||||
try:
|
||||
val = json.loads(self.scopes or '[]')
|
||||
except (ValueError, TypeError):
|
||||
val = []
|
||||
return val if isinstance(val, list) else []
|
||||
|
||||
def scopes_label(self):
|
||||
"""Texto para la UI: 'todos' o la lista de etiquetas."""
|
||||
scopes = self.scopes_list()
|
||||
if not scopes:
|
||||
return 'Todos'
|
||||
return ', '.join(SCOPE_LABEL.get(s, s) for s in scopes)
|
||||
|
||||
def permite(self, scope):
|
||||
"""True si la clave concede el alcance (vacío = todos). Nunca si inactiva."""
|
||||
if not self.activo:
|
||||
return False
|
||||
if self.vence and self.vence < fields.Date.today():
|
||||
return False
|
||||
scopes = self.scopes_list()
|
||||
if not scopes:
|
||||
return True
|
||||
return scope in scopes
|
||||
|
||||
def estado(self):
|
||||
if self.revocada_at or not self.activo:
|
||||
return 'revocada'
|
||||
if self.vence and self.vence < fields.Date.today():
|
||||
return 'vencida'
|
||||
return 'activa'
|
||||
|
||||
def to_public_dict(self):
|
||||
return {
|
||||
'id': self.id,
|
||||
'name': self.name,
|
||||
'prefijo': self.prefijo,
|
||||
'activo': self.activo,
|
||||
'scopes': self.scopes_list(),
|
||||
'scopes_label': self.scopes_label(),
|
||||
'vence': self.vence.strftime('%Y-%m-%d') if self.vence else '',
|
||||
'ultimo_uso': self.ultimo_uso.strftime('%Y-%m-%d %H:%M') if self.ultimo_uso else '',
|
||||
'usos': self.usos,
|
||||
'notas': self.notas or '',
|
||||
'creado_por_login': self.creado_por_login or '',
|
||||
'revocada_at': self.revocada_at.strftime('%Y-%m-%d %H:%M') if self.revocada_at else '',
|
||||
'revocada_por': self.revocada_por or '',
|
||||
'estado': self.estado(),
|
||||
}
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
@api.model
|
||||
def _autenticar(self, raw):
|
||||
"""Devuelve la clave activa que corresponde a `raw` (o recordset vacío)."""
|
||||
raw = (raw or '').strip()
|
||||
if not raw:
|
||||
return self.browse()
|
||||
candidatas = self.search([
|
||||
('prefijo', '=', raw[:PREFIJO_LARGO]), ('activo', '=', True),
|
||||
])
|
||||
digest = hash_clave(raw)
|
||||
for key in candidatas:
|
||||
if hmac.compare_digest(key.hash or '', digest):
|
||||
return key
|
||||
# Respaldo: por si el prefijo almacenado difiere, comparar por hash.
|
||||
return self.search([('hash', '=', digest), ('activo', '=', True)], limit=1)
|
||||
|
||||
def _registrar_uso(self):
|
||||
if not self:
|
||||
return
|
||||
self.sudo().write({
|
||||
'ultimo_uso': fields.Datetime.now(),
|
||||
'usos': self.usos + 1,
|
||||
})
|
||||
|
||||
def action_revocar(self, login=''):
|
||||
self.write({
|
||||
'activo': False,
|
||||
'revocada_at': fields.Datetime.now(),
|
||||
'revocada_por': login or '',
|
||||
})
|
||||
193
odoo-addons/skeen_plataforma/models/eventos.py
Normal file
193
odoo-addons/skeen_plataforma/models/eventos.py
Normal file
@@ -0,0 +1,193 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""Emisión de eventos de webhook desde los flujos existentes.
|
||||
|
||||
Cada override comprueba primero si hay algún webhook activo (una consulta
|
||||
barata sobre una tabla normalmente vacía); si no lo hay, se comporta
|
||||
EXACTAMENTE como antes y no crea ninguna fila. La entrega real es asíncrona
|
||||
(cron), así que aquí solo se encola.
|
||||
"""
|
||||
|
||||
import logging
|
||||
|
||||
from odoo import api, models
|
||||
|
||||
_logger = logging.getLogger(__name__)
|
||||
|
||||
|
||||
def _emitir(env, evento, payload, clave_unica=None):
|
||||
"""Encapsula la emisión para que NUNCA tumbe la operación de negocio."""
|
||||
try:
|
||||
service = env['skeen.webhook.service'].sudo()
|
||||
if not service.hay_activos():
|
||||
return
|
||||
service.emitir(evento, payload, clave_unica=clave_unica)
|
||||
except Exception:
|
||||
_logger.exception('No se pudo emitir el evento de webhook %s', evento)
|
||||
|
||||
|
||||
def _val(record, campo):
|
||||
valor = getattr(record, campo, None)
|
||||
if hasattr(valor, 'id'): # many2one
|
||||
return valor.id or False
|
||||
if hasattr(valor, 'name'): # recordset
|
||||
return valor.name
|
||||
if hasattr(valor, 'isoformat'): # fecha/datetime
|
||||
return valor.isoformat()
|
||||
return valor
|
||||
|
||||
|
||||
def _cita_payload(cita):
|
||||
return {
|
||||
'id': cita.id,
|
||||
'reference': cita.name,
|
||||
'state': cita.state,
|
||||
'date': cita.date.isoformat() if cita.date else '',
|
||||
'patient_id': cita.partner_id.id,
|
||||
'patient': cita.partner_id.name or '',
|
||||
'service_id': cita.servicio_id.id if cita.servicio_id else None,
|
||||
'servicio': cita.servicio_id.name if cita.servicio_id else '',
|
||||
'doctor': cita.doctor_id.name if getattr(cita, 'doctor_id', None) else '',
|
||||
}
|
||||
|
||||
|
||||
class SkeenCita(models.Model):
|
||||
_inherit = 'skeen.cita'
|
||||
|
||||
@api.model_create_multi
|
||||
def create(self, vals_list):
|
||||
citas = super().create(vals_list)
|
||||
for cita in citas:
|
||||
_emitir(self.env, 'cita.creada', _cita_payload(cita),
|
||||
clave_unica='cita.creada:%s' % cita.id)
|
||||
return citas
|
||||
|
||||
def write(self, vals):
|
||||
if 'state' not in vals:
|
||||
return super().write(vals)
|
||||
previo = {c.id: c.state for c in self}
|
||||
res = super().write(vals)
|
||||
destinos = {
|
||||
'confirmed': 'cita.confirmada',
|
||||
'cancelled': 'cita.cancelada',
|
||||
'no_show': 'cita.no_show',
|
||||
'done': 'cita.completada',
|
||||
}
|
||||
for cita in self:
|
||||
evento = destinos.get(cita.state)
|
||||
if evento and previo.get(cita.id) != cita.state:
|
||||
_emitir(self.env, evento, _cita_payload(cita),
|
||||
clave_unica='%s:%s' % (evento, cita.id))
|
||||
return res
|
||||
|
||||
|
||||
class SkeenVenta(models.Model):
|
||||
_inherit = 'skeen.venta'
|
||||
|
||||
def write(self, vals):
|
||||
if 'state' not in vals and 'refunded' not in vals:
|
||||
return super().write(vals)
|
||||
previo = {v.id: (v.state, v.refunded) for v in self}
|
||||
res = super().write(vals)
|
||||
for venta in self:
|
||||
antes = previo.get(venta.id, (None, None))
|
||||
if venta.state == 'paid' and antes[0] != 'paid':
|
||||
_emitir(self.env, 'venta.pagada', {
|
||||
'id': venta.id, 'reference': venta.name, 'state': venta.state,
|
||||
'total': _val(venta, 'total'), 'patient_id': venta.partner_id.id,
|
||||
}, clave_unica='venta.pagada:%s' % venta.id)
|
||||
if (venta.state == 'cancelled' and antes[0] != 'cancelled') or \
|
||||
(venta.refunded and not antes[1]):
|
||||
_emitir(self.env, 'venta.cancelada', {
|
||||
'id': venta.id, 'reference': venta.name, 'state': venta.state,
|
||||
'refunded': bool(venta.refunded), 'refund_amount': _val(venta, 'refund_amount'),
|
||||
}, clave_unica='venta.cancelada:%s' % venta.id)
|
||||
return res
|
||||
|
||||
|
||||
class SkeenPago(models.Model):
|
||||
_inherit = 'skeen.pago'
|
||||
|
||||
@api.model_create_multi
|
||||
def create(self, vals_list):
|
||||
pagos = super().create(vals_list)
|
||||
for pago in pagos:
|
||||
_emitir(self.env, 'pago.registrado', {
|
||||
'id': pago.id, 'reference': pago.name, 'amount': pago.amount,
|
||||
'payment_method': pago.payment_method, 'state': pago.state,
|
||||
'patient_id': pago.partner_id.id if pago.partner_id else None,
|
||||
}, clave_unica='pago.registrado:%s' % pago.id)
|
||||
return pagos
|
||||
|
||||
|
||||
class ResPartner(models.Model):
|
||||
_inherit = 'res.partner'
|
||||
|
||||
@api.model_create_multi
|
||||
def create(self, vals_list):
|
||||
partners = super().create(vals_list)
|
||||
for partner in partners:
|
||||
if not partner.is_patient:
|
||||
continue
|
||||
_emitir(self.env, 'paciente.creado', {
|
||||
'id': partner.id, 'name': partner.name,
|
||||
'phone': partner.phone or '', 'email': partner.email or '',
|
||||
'is_patient': True,
|
||||
}, clave_unica='paciente.creado:%s' % partner.id)
|
||||
return partners
|
||||
|
||||
|
||||
class SkeenMembresia(models.Model):
|
||||
_inherit = 'skeen.membresia'
|
||||
|
||||
def action_renovar(self, *args, **kwargs):
|
||||
res = super().action_renovar(*args, **kwargs)
|
||||
for membresia in self:
|
||||
_emitir(self.env, 'membresia.renovada', {
|
||||
'id': membresia.id,
|
||||
'plan': membresia.plan_id.name if membresia.plan_id else '',
|
||||
'estado': membresia.estado,
|
||||
'periodo_actual_inicio': _val(membresia, 'periodo_actual_inicio'),
|
||||
'periodo_actual_fin': _val(membresia, 'periodo_actual_fin'),
|
||||
'patient_id': membresia.partner_id.id if membresia.partner_id else None,
|
||||
}, clave_unica='membresia.renovada:%s:%s'
|
||||
% (membresia.id, _val(membresia, 'periodo_actual_inicio')))
|
||||
return res
|
||||
|
||||
|
||||
class SkeenFormularioRespuesta(models.Model):
|
||||
_inherit = 'skeen.formulario.respuesta'
|
||||
|
||||
def write(self, vals):
|
||||
if vals.get('estado') != 'llenado':
|
||||
return super().write(vals)
|
||||
previo = {r.id: r.estado for r in self}
|
||||
res = super().write(vals)
|
||||
for respuesta in self:
|
||||
if previo.get(respuesta.id) != 'llenado':
|
||||
_emitir(self.env, 'formulario.llenado', {
|
||||
'id': respuesta.id,
|
||||
'plantilla': _val(getattr(respuesta, 'plantilla_id', None), 'name')
|
||||
if getattr(respuesta, 'plantilla_id', None) else '',
|
||||
'estado': respuesta.estado,
|
||||
'patient_id': respuesta.partner_id.id if getattr(respuesta, 'partner_id', None) else None,
|
||||
}, clave_unica='formulario.llenado:%s' % respuesta.id)
|
||||
return res
|
||||
|
||||
|
||||
class SkeenCompra(models.Model):
|
||||
_inherit = 'skeen.compra'
|
||||
|
||||
def write(self, vals):
|
||||
if 'estado' not in vals:
|
||||
return super().write(vals)
|
||||
previo = {c.id: c.estado for c in self}
|
||||
res = super().write(vals)
|
||||
for compra in self:
|
||||
if compra.estado in ('recibida', 'recibida_parcial') \
|
||||
and previo.get(compra.id) != compra.estado:
|
||||
_emitir(self.env, 'compra.recibida', {
|
||||
'id': compra.id,
|
||||
'referencia': _val(compra, 'name') or _val(compra, 'referencia'),
|
||||
'estado': compra.estado,
|
||||
}, clave_unica='compra.recibida:%s:%s' % (compra.id, compra.estado))
|
||||
return res
|
||||
132
odoo-addons/skeen_plataforma/models/ir_http.py
Normal file
132
odoo-addons/skeen_plataforma/models/ir_http.py
Normal file
@@ -0,0 +1,132 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""Autenticación `api_key` para las rutas públicas `/skeen/api/v1/*`.
|
||||
|
||||
Odoo no trae un método de autenticación `api_key`; las rutas de
|
||||
`skeen_whatsapp/controllers/main.py` lo declaraban pero no existía, así que
|
||||
TODAS las peticiones respondían AccessDenied. Aquí se implementa el método que
|
||||
falta, sin cambiar ni el formato de la clave ni el de los encabezados:
|
||||
|
||||
1) CLave legacy de Hermes: `ir.config_parameter 'skeen.api.legacy_key'`
|
||||
(sembrada con `skeen_api_key_2026`).
|
||||
2) Claves del modelo `skeen.api.key` (hash, alcances, vencimiento, revocación).
|
||||
|
||||
La clave se lee de `Authorization: Bearer <clave>`, de `X-API-Key` o del
|
||||
parámetro `api_key` (query/form), que es lo que ya usaba Hermes.
|
||||
"""
|
||||
|
||||
import hmac
|
||||
import json
|
||||
|
||||
from werkzeug.exceptions import Forbidden
|
||||
|
||||
from odoo import SUPERUSER_ID, models, http
|
||||
from odoo.exceptions import AccessDenied
|
||||
from odoo.http import request, Response
|
||||
|
||||
from odoo.addons.skeen_citas.clinic_settings import licencia_de, modulo_bloqueado
|
||||
|
||||
LEGACY_KEY_PARAM = 'skeen.api.legacy_key'
|
||||
LEGACY_KEY_DEFAULT = 'skeen_api_key_2026'
|
||||
|
||||
# Rutas del frontend cuyo módulo se controla por licencia. Los módulos con
|
||||
# bloque `activo` (compras, membresías, comisiones, recursos, notificaciones,
|
||||
# reservas) ya responden 403 solos al apagarse, así que aquí solo hacen falta
|
||||
# los que no tienen ese bloque.
|
||||
RUTAS_LICENCIA = (
|
||||
('/skeen/frontend/v1/formularios', 'formularios'),
|
||||
('/skeen/frontend/v1/wacrm', 'whatsapp'),
|
||||
)
|
||||
|
||||
|
||||
def _respuesta_licencia():
|
||||
"""Respuesta 403 JSON si la ruta pertenece a un módulo fuera de la licencia.
|
||||
|
||||
Devuelve None si la petición puede continuar. No aplica a OPTIONS (preflight
|
||||
CORS) ni cuando no hay licencia en modo bloqueo."""
|
||||
try:
|
||||
if request.httprequest.method == 'OPTIONS':
|
||||
return None
|
||||
path = request.httprequest.path or ''
|
||||
modulo = next((m for prefijo, m in RUTAS_LICENCIA if path.startswith(prefijo)), None)
|
||||
if not modulo or not request.env:
|
||||
return None
|
||||
if not modulo_bloqueado(licencia_de(request.env), modulo):
|
||||
return None
|
||||
except Exception:
|
||||
return None
|
||||
cuerpo = json.dumps({'status': 'error',
|
||||
'message': 'Módulo no incluido en tu plan'},
|
||||
ensure_ascii=False)
|
||||
return Response(cuerpo, status=403, mimetype='application/json',
|
||||
headers={'Access-Control-Allow-Origin': '*'})
|
||||
|
||||
|
||||
def extraer_clave(req):
|
||||
"""Devuelve la clave de API de la petición (o '')."""
|
||||
try:
|
||||
headers = req.httprequest.headers
|
||||
auth = headers.get('Authorization', '') or ''
|
||||
if auth.lower().startswith('bearer '):
|
||||
return auth[7:].strip()
|
||||
for header in ('X-API-Key', 'X-Api-Key', 'Api-Key'):
|
||||
valor = headers.get(header)
|
||||
if valor:
|
||||
return valor.strip()
|
||||
args = req.httprequest.args
|
||||
for parametro in ('api_key', 'api-key', 'apikey'):
|
||||
if args.get(parametro):
|
||||
return args.get(parametro).strip()
|
||||
except Exception:
|
||||
return ''
|
||||
return ''
|
||||
|
||||
|
||||
def clave_permite_scope(req, scope):
|
||||
"""True si la clave de la petición concede el alcance `scope`.
|
||||
|
||||
La clave legacy de Hermes tiene todos los alcances. Una petición sin
|
||||
`request.api_key` (p. ej. dentro de pruebas) se considera legacy.
|
||||
"""
|
||||
key = getattr(req, 'api_key', None)
|
||||
if key is None:
|
||||
return True
|
||||
return key.permite(scope)
|
||||
|
||||
|
||||
def exigir_scope(req, scope):
|
||||
"""Lanza 403 (HTTP 403) si la clave no tiene el alcance indicado."""
|
||||
if not clave_permite_scope(req, scope):
|
||||
raise Forbidden(description='La clave de API no tiene el alcance "%s".' % scope)
|
||||
|
||||
|
||||
class IrHttp(models.AbstractModel):
|
||||
_inherit = 'ir.http'
|
||||
|
||||
@classmethod
|
||||
def _dispatch(cls, endpoint):
|
||||
respuesta = _respuesta_licencia()
|
||||
if respuesta is not None:
|
||||
return respuesta
|
||||
return super()._dispatch(endpoint)
|
||||
|
||||
@classmethod
|
||||
def _auth_method_api_key(cls):
|
||||
raw = extraer_clave(request)
|
||||
if not raw:
|
||||
raise AccessDenied('Falta la clave de API (Authorization: Bearer ...).')
|
||||
ICP = request.env['ir.config_parameter'].sudo()
|
||||
legacy = ICP.get_param(LEGACY_KEY_PARAM) or LEGACY_KEY_DEFAULT
|
||||
if hmac.compare_digest(raw, legacy):
|
||||
request.api_key = None
|
||||
request.api_key_legacy = True
|
||||
request.update_env(user=SUPERUSER_ID)
|
||||
return
|
||||
key = None
|
||||
if 'skeen.api.key' in request.env:
|
||||
key = request.env['skeen.api.key'].sudo()._autenticar(raw)
|
||||
if not key:
|
||||
raise AccessDenied('Clave de API inválida o revocada.')
|
||||
request.api_key = key
|
||||
request.api_key_legacy = False
|
||||
key._registrar_uso()
|
||||
request.update_env(user=SUPERUSER_ID)
|
||||
125
odoo-addons/skeen_plataforma/models/limites.py
Normal file
125
odoo-addons/skeen_plataforma/models/limites.py
Normal file
@@ -0,0 +1,125 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""Aplicación de los límites de la licencia.
|
||||
|
||||
Solo actúan con `modo='bloqueo'` y un límite > 0. Con `aviso` (default) o sin
|
||||
licencia no bloquean nada. Nunca afectan tareas internas: se pueden saltar con
|
||||
el contexto `skeen_licencia_skip=True` (cron, migraciones, importaciones).
|
||||
"""
|
||||
|
||||
import logging
|
||||
from datetime import date
|
||||
|
||||
from odoo import _, api, fields, models
|
||||
from odoo.exceptions import UserError
|
||||
|
||||
from odoo.addons.skeen_citas.clinic_settings import (
|
||||
licencia_de, limite_licencia, licencia_bloqueo_activo,
|
||||
)
|
||||
|
||||
_logger = logging.getLogger(__name__)
|
||||
|
||||
MENSAJES = {
|
||||
'usuarios_max': 'usuarios',
|
||||
'sucursales_max': 'sucursales',
|
||||
'citas_mes_max': 'citas este mes',
|
||||
'almacenamiento_mb': 'MB de almacenamiento',
|
||||
}
|
||||
|
||||
|
||||
def _skip(env):
|
||||
return bool(env.context.get('skeen_licencia_skip')
|
||||
or env.context.get('install_mode'))
|
||||
|
||||
|
||||
def exigir_limite(env, clave, etiqueta, actual, agregando=1):
|
||||
"""Lanza UserError si `actual + agregando` supera el límite de `clave`.
|
||||
|
||||
Con modo=aviso solo deja una advertencia en el log. Devuelve False si no
|
||||
aplica (sin licencia, sin límite o contexto de salto).
|
||||
"""
|
||||
limite = limite_licencia(env, clave)
|
||||
if limite <= 0 or _skip(env):
|
||||
return False
|
||||
licencia = licencia_de(env)
|
||||
if not licencia_bloqueo_activo(licencia):
|
||||
if actual + agregando > limite:
|
||||
_logger.info('SKEEN licencia (aviso): %s excede el límite de %s '
|
||||
'(%s + %s > %s)', etiqueta, limite, actual, agregando, limite)
|
||||
return False
|
||||
if actual + agregando > limite:
|
||||
raise UserError(_(
|
||||
'Tu plan permite hasta %(limite)s %(etiqueta)s y ya tienes '
|
||||
'%(actual)s. Para ampliar el límite, contacta a tu proveedor y '
|
||||
'solicita una licencia con un tope mayor.'
|
||||
) % {'limite': limite, 'etiqueta': etiqueta, 'actual': actual})
|
||||
return True
|
||||
|
||||
|
||||
def _contar_usuarios(env):
|
||||
return env['skeen.frontend.user'].sudo().search_count([('active', '=', True)])
|
||||
|
||||
|
||||
def _contar_sucursales(env):
|
||||
return env['skeen.sucursal'].sudo().search_count([('active', '=', True)])
|
||||
|
||||
|
||||
def _contar_citas_mes(env):
|
||||
hoy = date.today()
|
||||
inicio = hoy.replace(day=1)
|
||||
if hoy.month == 12:
|
||||
fin = hoy.replace(year=hoy.year + 1, month=1, day=1)
|
||||
else:
|
||||
fin = hoy.replace(month=hoy.month + 1, day=1)
|
||||
return env['skeen.cita'].sudo().search_count([
|
||||
('date', '>=', inicio), ('date', '<', fin),
|
||||
])
|
||||
|
||||
|
||||
def _mb_almacenamiento(env):
|
||||
env.cr.execute('SELECT COALESCE(SUM(file_size), 0) FROM ir_attachment')
|
||||
total = env.cr.fetchone()[0] or 0
|
||||
return total / (1024.0 * 1024.0)
|
||||
|
||||
|
||||
class SkeenFrontendUser(models.Model):
|
||||
_inherit = 'skeen.frontend.user'
|
||||
|
||||
@api.model_create_multi
|
||||
def create(self, vals_list):
|
||||
exigir_limite(self.env, 'usuarios_max', MENSAJES['usuarios_max'],
|
||||
_contar_usuarios(self.env), len(vals_list))
|
||||
return super().create(vals_list)
|
||||
|
||||
|
||||
class SkeenSucursal(models.Model):
|
||||
_inherit = 'skeen.sucursal'
|
||||
|
||||
@api.model_create_multi
|
||||
def create(self, vals_list):
|
||||
exigir_limite(self.env, 'sucursales_max', MENSAJES['sucursales_max'],
|
||||
_contar_sucursales(self.env), len(vals_list))
|
||||
return super().create(vals_list)
|
||||
|
||||
|
||||
class SkeenCita(models.Model):
|
||||
_inherit = 'skeen.cita'
|
||||
|
||||
@api.model_create_multi
|
||||
def create(self, vals_list):
|
||||
exigir_limite(self.env, 'citas_mes_max', MENSAJES['citas_mes_max'],
|
||||
_contar_citas_mes(self.env), len(vals_list))
|
||||
return super().create(vals_list)
|
||||
|
||||
|
||||
class IrAttachment(models.Model):
|
||||
_inherit = 'ir.attachment'
|
||||
|
||||
@api.model_create_multi
|
||||
def create(self, vals_list):
|
||||
if limite_licencia(self.env, 'almacenamiento_mb') > 0 and not _skip(self.env):
|
||||
nuevos_mb = sum(max(0, int(v.get('file_size') or 0)) for v in vals_list) \
|
||||
/ (1024.0 * 1024.0)
|
||||
exigir_limite(self.env, 'almacenamiento_mb',
|
||||
MENSAJES['almacenamiento_mb'],
|
||||
_mb_almacenamiento(self.env), nuevos_mb)
|
||||
return super().create(vals_list)
|
||||
367
odoo-addons/skeen_plataforma/models/webhook.py
Normal file
367
odoo-addons/skeen_plataforma/models/webhook.py
Normal file
@@ -0,0 +1,367 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""Webhooks salientes: outbox, entrega por cron, reintentos y log.
|
||||
|
||||
Sin webhooks activos suscritos a un evento NO se crea ninguna fila en el outbox
|
||||
y el cron no hace nada: cero impacto en una instancia sin configurar. La entrega
|
||||
es asíncrona (cron cada 5 minutos) para no añadir latencia a los flujos.
|
||||
|
||||
Firma: `X-Skeen-Signature: sha256=<HMAC-SHA256 del cuerpo con el secreto>`.
|
||||
"""
|
||||
|
||||
import hashlib
|
||||
import hmac
|
||||
import json
|
||||
import logging
|
||||
import uuid
|
||||
from datetime import timedelta
|
||||
|
||||
import requests
|
||||
|
||||
from odoo import api, fields, models
|
||||
|
||||
_logger = logging.getLogger(__name__)
|
||||
|
||||
# Catálogo de eventos emitibles (clave, etiqueta).
|
||||
EVENTOS = [
|
||||
('cita.creada', 'Cita creada'),
|
||||
('cita.confirmada', 'Cita confirmada'),
|
||||
('cita.cancelada', 'Cita cancelada'),
|
||||
('cita.no_show', 'Cita no presentada'),
|
||||
('cita.completada', 'Cita completada'),
|
||||
('venta.pagada', 'Venta pagada'),
|
||||
('venta.cancelada', 'Venta cancelada'),
|
||||
('pago.registrado', 'Pago registrado'),
|
||||
('paciente.creado', 'Paciente creado'),
|
||||
('membresia.renovada', 'Membresía renovada'),
|
||||
('formulario.llenado', 'Formulario llenado'),
|
||||
('compra.recibida', 'Compra recibida'),
|
||||
]
|
||||
EVENTO_KEYS = tuple(k for k, _l in EVENTOS)
|
||||
EVENTO_LABEL = dict(EVENTOS)
|
||||
|
||||
ESTADOS = [
|
||||
('pendiente', 'Pendiente'),
|
||||
('enviado', 'Enviado'),
|
||||
('fallido', 'Fallido'),
|
||||
('descartado', 'Descartado'),
|
||||
]
|
||||
|
||||
MAX_INTENTOS = 5
|
||||
BACKOFF_MIN = (1, 5, 30, 120, 360) # minutos entre reintentos
|
||||
TIMEOUT = (5, 15) # (conexión, lectura) segundos
|
||||
FALLOS_MAX_DEFAULT = 20
|
||||
PROCESAR_POR_DEFECTO = 100
|
||||
|
||||
|
||||
class SkeenWebhook(models.Model):
|
||||
_name = 'skeen.webhook'
|
||||
_description = 'Webhook saliente'
|
||||
_order = 'name, id'
|
||||
|
||||
name = fields.Char(string='Nombre', required=True)
|
||||
url = fields.Char(string='URL', required=True)
|
||||
eventos = fields.Char(string='Eventos', default='',
|
||||
help='Claves separadas por coma. Vacío = todos.')
|
||||
activo = fields.Boolean(string='Activo', default=True)
|
||||
secreto = fields.Char(string='Secreto', help='Con este secreto se firma cada entrega.')
|
||||
headers = fields.Text(string='Cabeceras extra (JSON)')
|
||||
notas = fields.Text(string='Notas')
|
||||
creado_por_login = fields.Char(string='Creado por')
|
||||
ultima_entrega_at = fields.Datetime(string='Última entrega')
|
||||
fallos_consecutivos = fields.Integer(string='Fallos consecutivos', default=0)
|
||||
|
||||
def eventos_list(self):
|
||||
return [e.strip() for e in (self.eventos or '').split(',') if e.strip()]
|
||||
|
||||
def suscrito(self, evento):
|
||||
"""True si el webhook recibe ese evento (lista vacía = todos)."""
|
||||
lista = self.eventos_list()
|
||||
return (not lista) or (evento in lista)
|
||||
|
||||
def headers_dict(self):
|
||||
try:
|
||||
val = json.loads(self.headers or '{}')
|
||||
except (ValueError, TypeError):
|
||||
return {}
|
||||
return val if isinstance(val, dict) else {}
|
||||
|
||||
def to_public_dict(self):
|
||||
return {
|
||||
'id': self.id,
|
||||
'name': self.name,
|
||||
'url': self.url,
|
||||
'eventos': self.eventos_list(),
|
||||
'eventos_label': 'Todos' if not self.eventos_list() else
|
||||
', '.join(EVENTO_LABEL.get(e, e) for e in self.eventos_list()),
|
||||
'activo': self.activo,
|
||||
'tiene_secreto': bool(self.secreto),
|
||||
'headers': self.headers_dict(),
|
||||
'notas': self.notas or '',
|
||||
'creado_por_login': self.creado_por_login or '',
|
||||
'ultima_entrega_at': self.ultima_entrega_at.strftime('%Y-%m-%d %H:%M')
|
||||
if self.ultima_entrega_at else '',
|
||||
'fallos_consecutivos': self.fallos_consecutivos,
|
||||
}
|
||||
|
||||
|
||||
class SkeenWebhookEvento(models.Model):
|
||||
_name = 'skeen.webhook.evento'
|
||||
_description = 'Evento de webhook (outbox)'
|
||||
_order = 'create_date desc, id desc'
|
||||
|
||||
webhook_id = fields.Many2one('skeen.webhook', string='Webhook', required=True,
|
||||
ondelete='cascade', index=True)
|
||||
evento = fields.Char(string='Evento', required=True, index=True)
|
||||
payload = fields.Text(string='Payload (JSON)')
|
||||
estado = fields.Selection(ESTADOS, string='Estado', default='pendiente',
|
||||
required=True, index=True)
|
||||
intentos = fields.Integer(string='Intentos', default=0)
|
||||
proximo_intento = fields.Datetime(string='Próximo intento', index=True)
|
||||
respuesta_codigo = fields.Integer(string='Código de respuesta')
|
||||
respuesta_texto = fields.Text(string='Respuesta')
|
||||
enviado_at = fields.Datetime(string='Enviado el')
|
||||
clave_unica = fields.Char(string='Clave única', index=True)
|
||||
|
||||
_sql_constraints = [
|
||||
('clave_unica_uniq', 'unique(clave_unica)',
|
||||
'Ya existe un evento con esa clave (evita duplicados).'),
|
||||
]
|
||||
|
||||
def to_public_dict(self):
|
||||
return {
|
||||
'id': self.id,
|
||||
'webhook_id': self.webhook_id.id,
|
||||
'webhook': self.webhook_id.name,
|
||||
'evento': self.evento,
|
||||
'evento_label': EVENTO_LABEL.get(self.evento, self.evento),
|
||||
'estado': self.estado,
|
||||
'estado_label': dict(ESTADOS).get(self.estado, self.estado),
|
||||
'intentos': self.intentos,
|
||||
'proximo_intento': self.proximo_intento.strftime('%Y-%m-%d %H:%M')
|
||||
if self.proximo_intento else '',
|
||||
'respuesta_codigo': self.respuesta_codigo or 0,
|
||||
'respuesta_texto': (self.respuesta_texto or '')[:500],
|
||||
'enviado_at': self.enviado_at.strftime('%Y-%m-%d %H:%M') if self.enviado_at else '',
|
||||
'creado_at': self.create_date.strftime('%Y-%m-%d %H:%M') if self.create_date else '',
|
||||
}
|
||||
|
||||
|
||||
class SkeenWebhookService(models.AbstractModel):
|
||||
_name = 'skeen.webhook.service'
|
||||
_description = 'Servicio de webhooks salientes'
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
# Emisión al outbox
|
||||
# ------------------------------------------------------------------
|
||||
@api.model
|
||||
def hay_activos(self):
|
||||
return bool(self.env['skeen.webhook'].sudo().search_count([('activo', '=', True)]))
|
||||
|
||||
@api.model
|
||||
def _suscriptores(self, evento):
|
||||
activos = self.env['skeen.webhook'].sudo().search([('activo', '=', True)])
|
||||
return activos.filtered(lambda w: w.suscrito(evento))
|
||||
|
||||
@api.model
|
||||
def emitir(self, evento, payload, clave_unica=None, webhook_ids=None):
|
||||
"""Encola el evento para los webhooks activos suscritos.
|
||||
|
||||
Sin webhooks activos suscritos no crea nada (cero impacto). Devuelve el
|
||||
recordset de eventos creados.
|
||||
"""
|
||||
if evento not in EVENTO_KEYS and evento != 'prueba':
|
||||
return self.env['skeen.webhook.evento'].browse()
|
||||
if webhook_ids is None:
|
||||
suscriptores = self._suscriptores(evento)
|
||||
else:
|
||||
suscriptores = self.env['skeen.webhook'].sudo().browse(webhook_ids)
|
||||
suscriptores = suscriptores.filtered(lambda w: w.suscrito(evento))
|
||||
if not suscriptores:
|
||||
return self.env['skeen.webhook.evento'].browse()
|
||||
Evento = self.env['skeen.webhook.evento'].sudo()
|
||||
texto = json.dumps(payload or {}, ensure_ascii=False, default=str)
|
||||
creados = Evento
|
||||
ahora = fields.Datetime.now()
|
||||
for webhook in suscriptores:
|
||||
clave = clave_unica
|
||||
if clave:
|
||||
clave = '%s:w%s' % (clave, webhook.id)
|
||||
if Evento.search_count([('clave_unica', '=', clave)]):
|
||||
continue
|
||||
creados |= Evento.create({
|
||||
'webhook_id': webhook.id,
|
||||
'evento': evento,
|
||||
'payload': texto,
|
||||
'estado': 'pendiente',
|
||||
'proximo_intento': ahora,
|
||||
'clave_unica': clave or None,
|
||||
})
|
||||
return creados
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
# Entrega
|
||||
# ------------------------------------------------------------------
|
||||
@api.model
|
||||
def _cron_tick(self):
|
||||
return self.procesar()
|
||||
|
||||
@api.model
|
||||
def procesar(self, limite=PROCESAR_POR_DEFECTO):
|
||||
"""Envía los eventos pendientes ya vencidos. Nunca detiene el cron."""
|
||||
ahora = fields.Datetime.now()
|
||||
pendientes = self.env['skeen.webhook.evento'].sudo().search([
|
||||
('estado', '=', 'pendiente'),
|
||||
('proximo_intento', '<=', ahora),
|
||||
], order='proximo_intento asc, id asc', limit=limite)
|
||||
resultado = {'revisados': len(pendientes), 'enviados': 0, 'fallidos': 0}
|
||||
for evento in pendientes:
|
||||
try:
|
||||
estado = self._entregar(evento)
|
||||
except Exception:
|
||||
_logger.exception('Webhook evento %s: error inesperado', evento.id)
|
||||
self._fallar(evento, 'Error inesperado al entregar')
|
||||
estado = 'fallido'
|
||||
if estado == 'enviado':
|
||||
resultado['enviados'] += 1
|
||||
elif estado == 'fallido':
|
||||
resultado['fallidos'] += 1
|
||||
if resultado['revisados']:
|
||||
_logger.info('SKEEN webhooks: %s', resultado)
|
||||
return resultado
|
||||
|
||||
@api.model
|
||||
def firmar(self, secreto, cuerpo_bytes):
|
||||
"""Firma `sha256=<hex>` del cuerpo con el secreto."""
|
||||
if not secreto:
|
||||
return ''
|
||||
digest = hmac.new(secreto.encode('utf-8'), cuerpo_bytes, hashlib.sha256)
|
||||
return 'sha256=' + digest.hexdigest()
|
||||
|
||||
@api.model
|
||||
def _entregar(self, evento):
|
||||
webhook = evento.webhook_id
|
||||
if not webhook.activo:
|
||||
evento.write({'estado': 'descartado',
|
||||
'respuesta_texto': 'El webhook está desactivado.'})
|
||||
return 'descartado'
|
||||
cuerpo = (evento.payload or '{}').encode('utf-8')
|
||||
headers = {
|
||||
'Content-Type': 'application/json',
|
||||
'X-Skeen-Event': evento.evento,
|
||||
'X-Skeen-Delivery': uuid.uuid4().hex,
|
||||
}
|
||||
firma = self.firmar(webhook.secreto or '', cuerpo)
|
||||
if firma:
|
||||
headers['X-Skeen-Signature'] = firma
|
||||
for k, v in (webhook.headers_dict() or {}).items():
|
||||
headers[str(k)] = str(v)
|
||||
try:
|
||||
resp = requests.post(webhook.url, data=cuerpo, headers=headers,
|
||||
timeout=TIMEOUT)
|
||||
codigo = resp.status_code
|
||||
texto = (resp.text or '')[:500]
|
||||
except requests.RequestException as exc:
|
||||
self._fallar(evento, 'No se pudo conectar: %s' % exc)
|
||||
return 'fallido'
|
||||
if 200 <= codigo < 300:
|
||||
evento.write({
|
||||
'estado': 'enviado', 'intentos': evento.intentos + 1,
|
||||
'enviado_at': fields.Datetime.now(), 'respuesta_codigo': codigo,
|
||||
'respuesta_texto': texto,
|
||||
})
|
||||
webhook.write({'ultima_entrega_at': fields.Datetime.now(),
|
||||
'fallos_consecutivos': 0})
|
||||
return 'enviado'
|
||||
self._fallar(evento, texto or ('HTTP %s' % codigo), codigo=codigo)
|
||||
return 'fallido'
|
||||
|
||||
@api.model
|
||||
def _fallar(self, evento, texto, codigo=0):
|
||||
intentos = evento.intentos + 1
|
||||
vals = {'intentos': intentos, 'respuesta_codigo': codigo,
|
||||
'respuesta_texto': (texto or '')[:500]}
|
||||
if intentos >= MAX_INTENTOS:
|
||||
vals['estado'] = 'fallido'
|
||||
else:
|
||||
espera = BACKOFF_MIN[min(intentos - 1, len(BACKOFF_MIN) - 1)]
|
||||
vals['proximo_intento'] = fields.Datetime.now() + timedelta(minutes=espera)
|
||||
evento.write(vals)
|
||||
webhook = evento.webhook_id
|
||||
fallos = webhook.fallos_consecutivos + 1
|
||||
umbral = self._umbral_fallos()
|
||||
vals_wh = {'fallos_consecutivos': fallos}
|
||||
if umbral and fallos >= umbral:
|
||||
vals_wh['activo'] = False
|
||||
_logger.warning('SKEEN webhook %s desactivado tras %s fallos consecutivos',
|
||||
webhook.id, fallos)
|
||||
webhook.write(vals_wh)
|
||||
|
||||
@api.model
|
||||
def _umbral_fallos(self):
|
||||
raw = self.env['ir.config_parameter'].sudo().get_param('skeen.webhooks.fallos_max')
|
||||
try:
|
||||
return int(raw) if raw else FALLOS_MAX_DEFAULT
|
||||
except (TypeError, ValueError):
|
||||
return FALLOS_MAX_DEFAULT
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
# Acciones de UI
|
||||
# ------------------------------------------------------------------
|
||||
@api.model
|
||||
def reintentar(self, evento):
|
||||
"""Devuelve a la cola un evento fallido y lo intenta de inmediato."""
|
||||
if evento.estado in ('enviado', 'descartado'):
|
||||
return evento.estado
|
||||
evento.write({'estado': 'pendiente', 'proximo_intento': fields.Datetime.now()})
|
||||
return self._entregar(evento)
|
||||
|
||||
@api.model
|
||||
def probar(self, webhook, login=''):
|
||||
"""Envía un evento de prueba (ignora la suscripción) y devuelve el log."""
|
||||
ejemplo = {
|
||||
'evento': 'prueba',
|
||||
'mensaje': 'Prueba de webhook SKEEN',
|
||||
'webhook': webhook.name,
|
||||
'generado_por': login or 'sistema',
|
||||
}
|
||||
evento = self.env['skeen.webhook.evento'].sudo().create({
|
||||
'webhook_id': webhook.id,
|
||||
'evento': 'prueba',
|
||||
'payload': json.dumps(ejemplo, ensure_ascii=False),
|
||||
'estado': 'pendiente',
|
||||
'proximo_intento': fields.Datetime.now(),
|
||||
})
|
||||
estado = self._entregar(evento)
|
||||
ok = estado == 'enviado'
|
||||
mensaje = ('Entrega de prueba correcta.' if ok
|
||||
else 'La entrega falló (código %s): %s'
|
||||
% (evento.respuesta_codigo or 0, evento.respuesta_texto or ''))
|
||||
return ok, mensaje, evento
|
||||
|
||||
@api.model
|
||||
def payload_ejemplo(self, evento):
|
||||
"""Payload de ejemplo de un evento, para el visor de la UI."""
|
||||
payloads = {
|
||||
'cita.creada': {'id': 123, 'reference': 'CITA-0123', 'state': 'pending',
|
||||
'date': '2026-10-20', 'time': '10:30',
|
||||
'patient_id': 55, 'patient': 'María López',
|
||||
'service_id': 7, 'servicio': 'Limpieza facial'},
|
||||
'cita.confirmada': {'id': 123, 'reference': 'CITA-0123', 'state': 'confirmed'},
|
||||
'cita.cancelada': {'id': 123, 'reference': 'CITA-0123', 'state': 'cancelled'},
|
||||
'cita.no_show': {'id': 123, 'reference': 'CITA-0123', 'state': 'no_show'},
|
||||
'cita.completada': {'id': 123, 'reference': 'CITA-0123', 'state': 'done'},
|
||||
'venta.pagada': {'id': 900, 'reference': 'V-00900', 'state': 'paid',
|
||||
'total': 1500.0, 'patient_id': 55},
|
||||
'venta.cancelada': {'id': 900, 'reference': 'V-00900', 'state': 'cancelled'},
|
||||
'pago.registrado': {'id': 700, 'reference': 'P-00700', 'amount': 500.0,
|
||||
'payment_method': 'cash', 'patient_id': 55},
|
||||
'paciente.creado': {'id': 55, 'name': 'María López', 'phone': '+526641234567',
|
||||
'is_patient': True},
|
||||
'membresia.renovada': {'id': 30, 'plan': 'Mensual', 'estado': 'activa',
|
||||
'periodo_actual_inicio': '2026-11-01',
|
||||
'periodo_actual_fin': '2026-11-30'},
|
||||
'formulario.llenado': {'id': 12, 'plantilla': 'Consentimiento',
|
||||
'estado': 'llenado', 'patient_id': 55},
|
||||
'compra.recibida': {'id': 44, 'referencia': 'OC-0044', 'estado': 'recibida'},
|
||||
}
|
||||
return payloads.get(evento, {'evento': evento})
|
||||
Reference in New Issue
Block a user