KnowledgebaseCAPITAL

🤖 PLATAFORMA DE CRÉDITOS IA - CÍRCULO DE CRÉDITO

Plataforma automática de otorgamiento de créditos usando APIs de Círculo de Crédito con autenticación ECDSA P-384 completa. Diseñada y desarrollada por nuestro equipo para acelerar el onboarding y la evaluación de riesgo de forma confiable y auditable.

Repositorio: https://github.com/abalderas10/Agent-circulocredito

Ventajas Clave

📋 DESCRIPCIÓN

Este agente IA evalúa solicitudes de crédito de personas físicas mexicanas siguiendo un flujo automatizado de 5 fases con seguridad ECDSA completa:

🔐 CARACTERÍSTICAS DE SEGURIDAD

📋 APIs INTEGRADAS

🐳 DESPLIEGUE CON DOCKER (RECOMENDADO)

Opción Rápida con Docker:

# 1. Clonar repositorio
git clone https://github.com/abalderas10/Agent-circulocredito.git
cd Agent-circulocredito

# 2. Configurar variables de entorno
cp .env.example .env
# Editar .env con tus credenciales reales

# 3. Generar certificados
./run_docker.sh build
./run_docker.sh interactive

# Dentro del contenedor, ejecutar:
python setup_security.py

# Salir del contenedor y continuar

# 4. Subir certificado a Círculo de Crédito
# Seguir instrucciones en security/INSTRUCCIONES.txt

# 5. Probar el sistema
./run_docker.sh test

🚀 GUÍA COMPLETA DE IMPLEMENTACIÓN (Opción Manual)

PASO 1: GENERAR CERTIFICADOS ECDSA P-384

Ejecuta esto en tu terminal (Linux/Mac/WSL):

# Crear directorio de seguridad
mkdir -p ./security
cd ./security

# 1. Generar llave privada ECDSA P-384
openssl ecparam -name secp384r1 -genkey -out pri_key.pem

# 2. Generar certificado auto-firmado
openssl req -new -x509 -days 365 \
    -key pri_key.pem \
    -out certificate.pem \
    -subj "/C=MX/ST=CDMX/L=Mexico/O=GrowthBDM/CN=plataforma-creditos-ai"

# 3. Extraer llave privada (para referencia)
openssl ec -in pri_key.pem -noout -text > key_extract.txt

echo "✅ Certificados generados exitosamente"
ls -la pri_key.pem certificate.pem

Archivos generados:

PASO 2: SUBIR CERTIFICADO A APIHUB

  1. Ir a: https://developer.circulodecredito.com.mx/user/apps
  2. Seleccionar app: plataforma-creditos-ai
  3. Sección: "Certificados para plataforma-creditos-ai"
  4. Subir: certificate.pem
  5. Descargar: El certificado de Círculo de Crédito (ej: cdc_cert_4398.pem)
  6. Guardar en: ./security/cdc_cert.pem

PASO 3: INSTALACIÓN Y CONFIGURACIÓN

# 1. Clonar repositorio
git clone https://github.com/tu-usuario/plataforma-creditos-ai.git
cd plataforma-creditos-ai

# 2. Instalar dependencias
pip install -r requirements.txt

# 3. Configurar variables de entorno
cp .env.example .env
# Editar .env con tus valores

PASO 4: ESTRUCTURA DE DIRECTORIOS COMPLETA

tu-proyecto/
├── security/
│   ├── pri_key.pem              # 🔒 Llave privada
│   ├── certificate.pem          # Tu certificado público
│   ├── cdc_cert.pem            # Certificado de Círculo de Crédito
│   └── key_extract.txt         # Referencia
│
├── src/
│   ├── security/
│   │   ├── __init__.py
│   │   └── ecdsa_manager.py    # Gestor de firmas ECDSA
│   │
│   ├── api/
│   │   ├── __init__.py
│   │   ├── client.py           # Cliente HTTP seguro
│   │   └── endpoints.py        # Funciones específicas de APIs
│   │
│   ├── agent/
│   │   ├── __init__.py
│   │   ├── evaluator.py        # Agente evaluador crediticio
│   │   └── rules.py            # Reglas de decisión
│   │
│   └── main.py                 # Script principal
│
├── requirements.txt
├── config.py
├── .env
├── .env.example
├── test_data.json
└── README.md

Para leer la documentación completa, consulta el repositorio en GitHub.

Integración con Frontend (Textos y Flujo)

Uso recomendado