GrappleAI - Capa de Defensa Activa para Consumidores

Una plataforma de resolución de disputas impulsada por IA, construida con frontend React y backend AWS CDK Lambda. GrappleAI defiende a los consumidores en disputas posteriores a la compra utilizando agentes autónomos y el Protocolo de Contexto de Modelo (MCP).

🚀 Inicio rápido

Ponte en marcha en 5 minutos:

# Frontend
cd app && npm install && npm run dev

# Backend (separate terminal)
cd backend && npm install && npm run cdk:deploy

Consulta QUICKSTART.md para obtener instrucciones detalladas.

Related MCP server: korean-privacy-law-mcp

📚 Documentación

Primeros pasos

• Guía de inicio rápido - Ponte en marcha en 5 minutos

• Guía de configuración completa - Instrucciones detalladas de configuración

• Descripción general del proyecto - Arquitectura y características

Metodología y Visión

• Metodología AI-DLC - Ciclo de vida de desarrollo impulsado por IA

• SDLC tradicional - Comparación entre SDLC y AIDLC

• Concepto GrappleAI - Planteamiento del problema y visión

• Detalles de AI-DLC - Capa de Defensa Activa para Consumidores

Documentación de componentes

• README del frontend - Detalles de la app React

• README del backend - Detalles del backend AWS CDK

🏗️ Arquitectura

React Frontend (Vite)
        ↓ HTTP/REST
API Gateway (AWS)
        ↓
Lambda Function (Node.js 20.x)
        ├─ MCP Server
        ├─ Request Handler
        └─ Business Logic
        ↓
    ┌───┴───┬────────┐
    ↓       ↓        ↓
DynamoDB  S3      DynamoDB
Disputes  Evidence Negotiations

✨ Características

• Gestión de disputas - Crear, rastrear y gestionar disputas

• Verificación de evidencia - Puntuación de confianza automática y almacenamiento seguro

• Negociación autónoma - Negociación impulsada por IA con vendedores

• Derechos del consumidor - Integración con la Ley de Protección al Consumidor de 2019

• Analíticas del panel - Estadísticas de disputas en tiempo real

• Soporte multilingüe - Soporte de interfaz en lenguas vernáculas

🛠️ Stack tecnológico

Frontend

• React 18 + TypeScript

• Vite (build tool)

• Tailwind CSS (styling)

• Zustand (state management)

• React Router (navigation)

Backend

• AWS CDK (infraestructura como código)

• AWS Lambda (computación sin servidor)

• AWS API Gateway (REST API)

• AWS DynamoDB (base de datos)

• AWS S3 (almacenamiento)

• Node.js 20.x

📁 Estructura del proyecto

grappleai/
├── app/                    # React frontend
│   ├── src/
│   │   ├── components/    # React components
│   │   ├── pages/         # Page components
│   │   ├── services/      # API client
│   │   ├── store/         # State management
│   │   └── types/         # TypeScript types
│   └── package.json
│
├── backend/               # AWS CDK backend
│   ├── lib/
│   │   ├── cdk/          # CDK stack
│   │   ├── lambda/       # Lambda handler
│   │   ├── mcp/          # MCP server
│   │   └── types/        # TypeScript types
│   └── package.json
│
├── SDLC to AIDLC/        # Methodology docs
│   ├── AIDLC.md
│   └── SDLC.md
│
├── AI-DLC/               # AI-DLC documentation
│   └── AI-DLC.md
│
├── QUICKSTART.md         # 5-minute setup
├── SETUP.md              # Complete setup guide
├── PROJECT_OVERVIEW.md   # Architecture overview
└── README.md             # This file

🚀 Primeros pasos

Requisitos previos

• Node.js 18+

• AWS Account

• AWS CLI configured

Configuración del frontend

cd app
npm install
npm run dev

Visita: http://localhost:5173

Configuración del backend

cd backend
npm install
npm run cdk:deploy

Conectar frontend con backend

Actualiza app/.env.local:

VITE_API_URL=https://your-api-endpoint.com/api

📖 Endpoints de la API

Disputas

• POST /disputes - Crear disputa

• GET /disputes - Listar disputas

• GET /disputes/{id} - Obtener detalles de la disputa

• PUT /disputes/{id} - Actualizar disputa

Evidencia

• POST /evidence/upload - Subir evidencia

• GET /evidence/{id} - Obtener evidencia

• POST /evidence/{id}/verify - Verificar evidencia

Negociación

• POST /negotiation/initiate - Iniciar negociación

• GET /negotiation/{txId} - Obtener estado

🔧 Herramientas del servidor MCP

El backend implementa estas herramientas MCP:

1. secureEvidence - Asegurar evidencia de forma segura con puntuación de confianza

2. negotiateRefund - Iniciar negociación autónoma

3. generateDisputeNotice - Generar notificación formal de disputa

4. verifyConsumerRights - Verificar derechos según la Ley de Protección al Consumidor

📊 Características del panel

• Estadísticas - Total de disputas, resueltas, en curso, tasa de éxito

• Lista de disputas - Ver todas las disputas con indicadores de estado

• Crear disputa - Presentar nuevas disputas con evidencia

• Actualizaciones en tiempo real - Seguimiento del progreso de la disputa

🔐 Seguridad

• JWT/OAuth2 ready

• Validación de entrada

• Roles IAM con privilegios mínimos

• Cifrado en reposo y en tránsito

• CORS enabled

• Límite de tasa de API listo

📈 Rendimiento

• Frontend: ~50KB comprimido con gzip

• Lambda: 512 MB de memoria, tiempo de espera de 30 s

• DynamoDB: Facturación bajo demanda

• API: tiempo de respuesta <100 ms

💰 Estimación de costos

Mensual (uso pequeño-mediano):

• Lambda: $0.20 por 1M de solicitudes

• DynamoDB: $1.25 por 100 unidades de escritura

• S3: $0.023 por GB

• API Gateway: $3.50 por 1M de solicitudes

• Total: ~$50-200/mes

🧪 Desarrollo

Comandos del frontend

npm run dev          # Start dev server
npm run build        # Build for production
npm run lint         # Run linter
npm run type-check   # Check types

Comandos del backend

npm run build        # Compile TypeScript
npm run cdk:deploy   # Deploy to AWS
npm run cdk:destroy  # Destroy stack
npm run cdk:diff     # Preview changes

🚢 Despliegue

Frontend

• Vercel: vercel deploy

• Netlify: netlify deploy --prod --dir=dist

• AWS S3: aws s3 sync dist/ s3://bucket/

Backend

cd backend
npm run cdk:deploy

📚 Más información

• AWS CDK Documentation

• React Documentation

• Model Context Protocol

• Consumer Protection Act 2019

🤝 Contribuciones

1. Crear una rama de características

2. Realizar cambios

3. Ejecutar linter y verificación de tipos

4. Enviar PR

📄 Licencia

MIT

🎯 Visión

GrappleAI está construyendo la capa de confianza para la economía digital de la India. Al combinar IA, derecho y tecnología, estamos creando un defensor activo para cada consumidor, asegurando que las disputas se resuelvan de manera justa, rápida y en el idioma preferido del consumidor.

¿Listo para construir? ¡Comienza con QUICKSTART.md!

GrappleAI - Capa de Defensa Activa para Consumidores Construyendo confianza en la economía digital de la India, una disputa a la vez.