GrappleAI - Aktive Verteidigungsschicht für Verbraucher

Eine KI-gesteuerte Streitbeilegungsplattform, die mit einem React-Frontend und einem AWS-CDK-Lambda-Backend aufgebaut ist. GrappleAI setzt sich für Verbraucher in Streitigkeiten nach dem Kauf ein, unter Verwendung autonomer Agenten und des Model Context Protocol (MCP).

🚀 Schnellstart

In 5 Minuten startklar:

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

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

Siehe QUICKSTART.md für detaillierte Anweisungen.

Related MCP server: EU AI Act Compliance MCP Server

📚 Dokumentation

Erste Schritte

• Schnellstart-Anleitung - In 5 Minuten startklar

• Vollständige Einrichtungsanleitung - Detaillierte Einrichtungsanweisungen

• Projektübersicht - Architektur und Funktionen

Methodik & Vision

• AI-DLC-Methodik - KI-gesteuerter Entwicklungslebenszyklus

• Traditioneller SDLC - SDLC vs AIDLC Vergleich

• GrappleAI-Konzept - Problemstellung und Vision

• AI-DLC-Details - Aktive Verteidigungsschicht für Verbraucher

Komponentendokumentation

• Frontend-README - React-App-Details

• Backend-README - AWS-CDK-Backend-Details

🏗️ Architektur

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

✨ Funktionen

• Streitfallverwaltung - Streitfälle erstellen, verfolgen und verwalten

• Beweisverifizierung - Automatische Konfidenzbewertung und sichere Speicherung

• Autonome Verhandlung - KI-gesteuerte Verhandlung mit Verkäufern

• Verbraucherrechte - Integration des Consumer Protection Act 2019

• Dashboard-Analysen - Echtzeit-Statistiken zu Streitfällen

• Mehrsprachige Unterstützung - Unterstützung für regionale Sprachen

🛠️ Technologie-Stack

Frontend

• React 18 + TypeScript

• Vite (Build-Tool)

• Tailwind CSS (Styling)

• Zustand (Zustandsverwaltung)

• React Router (Navigation)

Backend

• AWS CDK (Infrastruktur als Code)

• AWS Lambda (serverloses Rechnen)

• AWS API Gateway (REST-API)

• AWS DynamoDB (Datenbank)

• AWS S3 (Speicher)

• Node.js 20.x

📁 Projektstruktur

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

🚀 Erste Schritte

Voraussetzungen

• Node.js 18+

• AWS-Konto

• AWS CLI konfiguriert

Frontend-Einrichtung

cd app
npm install
npm run dev

Besuchen Sie: http://localhost:5173

Backend-Einrichtung

cd backend
npm install
npm run cdk:deploy

Frontend mit Backend verbinden

Aktualisieren Sie app/.env.local:

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

📖 API-Endpunkte

Streitfälle

• POST /disputes - Streitfall erstellen

• GET /disputes - Streitfälle auflisten

• GET /disputes/{id} - Streitfalldetails abrufen

• PUT /disputes/{id} - Streitfall aktualisieren

Beweise

• POST /evidence/upload - Beweise hochladen

• GET /evidence/{id} - Beweise abrufen

• POST /evidence/{id}/verify - Beweise verifizieren

Verhandlung

• POST /negotiation/initiate - Verhandlung starten

• GET /negotiation/{txId} - Status abrufen

🔧 MCP-Server-Tools

Das Backend implementiert diese MCP-Tools:

1. secureEvidence - Beweise sicher mit Konfidenzbewertung sichern

2. negotiateRefund - Autonome Verhandlung einleiten

3. generateDisputeNotice - Formelle Streitfallmitteilung erstellen

4. verifyConsumerRights - Rechte nach dem Consumer Protection Act überprüfen

📊 Dashboard-Funktionen

• Statistiken - Gesamtstreitfälle, erledigt, in Bearbeitung, Erfolgsquote

• Streitfallliste - Alle Streitfälle mit Statusanzeigen anzeigen

• Streitfall erstellen - Neue Streitfälle mit Beweisen einreichen

• Echtzeit-Updates - Streitfallfortschritt verfolgen

🔐 Sicherheit

• JWT/OAuth2 ready

• Eingabevalidierung

• IAM-Rollen mit minimalen Berechtigungen

• Verschlüsselung im Ruhezustand und während der Übertragung

• CORS aktiviert

• API-Ratenbegrenzung bereit

📈 Leistung

• Frontend: ~50KB gzipped

• Lambda: 512MB memory, 30s timeout

• DynamoDB: On-Demand-Abrechnung

• API: <100ms Antwortzeit

💰 Kostenschätzung

Monatlich (kleine bis mittlere Nutzung):

• Lambda: 0,20 $ pro 1 Mio. Anfragen

• DynamoDB: 1,25 $ pro 100 Schreibeinheiten

• S3: 0,023 $ pro GB

• API Gateway: 3,50 $ pro 1 Mio. Anfragen

• Gesamt: ~50-200 $/Monat

🧪 Entwicklung

Frontend-Befehle

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

Backend-Befehle

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

🚢 Bereitstellung

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

📚 Mehr erfahren

• AWS CDK Documentation

• React Documentation

• Model Context Protocol

• Consumer Protection Act 2019

🤝 Mitwirken

1. Feature-Branch erstellen

2. Änderungen vornehmen

3. Linter und Typprüfung ausführen

4. PR einreichen

📄 Lizenz

MIT

🎯 Vision

GrappleAI baut die Vertrauensschicht für Indiens digitale Wirtschaft. Durch die Kombination von KI, Recht und Technologie schaffen wir einen aktiven Fürsprecher für jeden Verbraucher – und stellen sicher, dass Streitfälle fair, schnell und in der bevorzugten Sprache des Verbrauchers gelöst werden.

Bereit zu bauen? Starten Sie mit QUICKSTART.md!

GrappleAI - Active Defense Layer for Consumers Vertrauen in Indiens digitale Wirtschaft aufbauen, ein Streitfall nach dem anderen.