📚 Glosario Técnico

Este glosario proporciona definiciones de los términos técnicos clave utilizados en la documentación del P2P Dashboard. Está diseñado para ayudar a los lectores a comprender la terminología específica del proyecto y del dominio de las criptomonedas P2P.

Términos Generales

API (Application Programming Interface): Interfaz de programación de aplicaciones. Un conjunto de reglas y protocolos que permite que diferentes aplicaciones de software se comuniquen entre sí.
Backend: La parte de una aplicación que se ejecuta en el servidor y maneja la lógica de negocio, la base de datos y la comunicación con otros servicios.
Frontend: La parte de una aplicación con la que el usuario interactúa directamente; la interfaz de usuario (UI).
Full-Stack: Un desarrollador o una aplicación que abarca tanto el frontend como el backend.
KPI (Key Performance Indicator): Indicador Clave de Rendimiento. Una métrica cuantificable que se utiliza para evaluar el éxito de una actividad o proceso.
Logging: El proceso de registrar eventos que ocurren en una aplicación o sistema. Es crucial para la depuración, el monitoreo y la auditoría.
Microservicio: Un enfoque arquitectónico que estructura una aplicación como una colección de servicios pequeños, independientes y débilmente acoplados.
Monitoreo: El proceso de observar y recopilar datos sobre el rendimiento y la salud de un sistema o aplicación.
ORM (Object-Relational Mapper): Mapeador Objeto-Relacional. Una técnica de programación que convierte datos entre sistemas de tipos incompatibles utilizando lenguajes de programación orientados a objetos.
PaaS (Platform as a Service): Plataforma como Servicio. Un modelo de computación en la nube que proporciona una plataforma y un entorno para que los desarrolladores creen, ejecuten y gestionen aplicaciones sin la complejidad de construir y mantener la infraestructura.
P2P (Peer-to-Peer): De igual a igual. Un modelo de red donde los participantes (pares) pueden comunicarse directamente entre sí sin la necesidad de un servidor central.
Scraping: La técnica de extraer datos de sitios web, generalmente mediante la automatización de solicitudes HTTP y el análisis del HTML resultante.
SQL (Structured Query Language): Lenguaje de Consulta Estructurado. Un lenguaje de programación utilizado para gestionar y manipular bases de datos relacionales.
Trazabilidad: La capacidad de rastrear el historial, la ubicación o la aplicación de un elemento mediante una identificación registrada.
UX (User Experience): Experiencia de Usuario. Se refiere a cómo se siente una persona al interactuar con un sistema, producto o servicio.

Términos Específicos del P2P Dashboard

Advertiser (Anunciante/Comerciante): Un usuario en una plataforma P2P que publica ofertas de compra o venta de criptomonedas.
Alembic: Herramienta de migraciones de base de datos para SQLAlchemy, utilizada para gestionar los cambios en el esquema de la base de datos de forma controlada.
API Key: Una clave de autenticación utilizada por los Workers externos para acceder a la API de Ingesta del P2P Dashboard.
Asset (Activo): La criptomoneda que se está comprando o vendiendo en una oferta P2P (ej. USDT, BTC, ETH).
FastAPI: Un framework web moderno y rápido para construir APIs con Python, basado en estándares de API abiertos como OpenAPI y JSON Schema.
Fiat: Moneda fiduciaria; la moneda de curso legal emitida por un gobierno (ej. ARS, USD, EUR).
JWT (JSON Web Token): Un estándar abierto (RFC 7519) que define una forma compacta y autocontenida para transmitir información de forma segura entre partes como un objeto JSON. Utilizado para la autenticación de usuarios administrativos.
Offer (Oferta): Una publicación en una plataforma P2P que detalla la intención de un anunciante de comprar o vender una criptomoneda a un precio y cantidad específicos, con métodos de pago definidos.
Payment Method (Método de Pago): La forma en que se realizará la transacción de dinero fiat (ej. Transferencia Bancaria, Mercado Pago, PayPal).
PostgreSQL: Un sistema de gestión de bases de datos relacionales de código abierto, robusto y altamente escalable, utilizado como la base de datos principal del P2P Dashboard.
Run: Un registro en la base de datos que representa una única ejecución del Worker de ingesta de datos. Contiene metadatos sobre la extracción, como la marca de tiempo y el número de ofertas procesadas.
ScraperError: Una excepción personalizada utilizada en el P2P Dashboard para manejar errores específicos relacionados con el proceso de scraping o ingesta de datos.
Spread: La diferencia entre el precio de compra y el precio de venta de un activo. En el contexto P2P, se refiere a la diferencia entre las mejores ofertas de compra y venta para un par de activo/fiat.
SQLAlchemy: Un kit de herramientas SQL y Object-Relational Mapper (ORM) para Python que proporciona un conjunto completo de patrones de persistencia de objetos de nivel empresarial.
Streamlit / Dash / Next.js: Ejemplos de frameworks o librerías que pueden ser utilizados para construir la Capa de Visualización (Frontend) del P2P Dashboard.
Trade Type (Tipo de Operación): Indica si una oferta es para BUY (comprar cripto con fiat) o SELL (vender cripto por fiat).
Worker: Un componente externo (generalmente un script o servicio Python) que se encarga de extraer datos de las plataformas P2P y enviarlos a la API de Ingesta.