adapter.py
Implementación del protocolo BrightmarketAdapter — lectura desde tu fuente.
src/adapter.py define ClientAdapter, que lee datos de tu fuente y expone filas crudas a los módulos de sync.
Debe implementar todos los métodos de BrightmarketAdapter.
Métodos requeridos
| Método | Uso | Columnas clave |
|---|---|---|
get_clients_created | Clientes nuevos | IdCliente, Nombre, RUC, FechaNacimiento, Sexo, IdDepartamento |
get_clients_modified | Clientes modificados | Misma forma que get_clients_created |
get_skus | Artículos/SKUs | CodigoArticulo, CodigoInterno, Descripcion, Marca, Precio, … |
get_tickets | Tickets (una fila por línea) | IdTicket, Fecha, IdCliente, SKU, Cantidad, Precio, … |
get_payment_methods | Métodos de pago | IdValor, NombreMetodo |
get_promotions | Promociones | Dicts promotion_data o filas a transformar |
get_rewards | Rewards (opcional) | IdCliente, Segmento, Mensaje, Incentivo, FechaVencimiento |
get_points_movements | Movimientos de puntos (opcional) | IdCliente, TipoMovimiento, Puntos, FechaVencimiento, Comentarios |
Patrón recomendado
- Implementá un método a la vez
- Usá
_date_filter()para filtrosfrom_date/to_datedel CLI - Devolvé
list[dict]con los nombres de columna del protocolo - Probá con el flag de sync correspondiente antes de pasar al siguiente
La transformación a payloads de API ocurre en src/sync/*, no en el adapter.