GrappleAI - Active Defense Layer for Consumers

An AI-driven dispute resolution platform built with React frontend and AWS CDK Lambda backend. GrappleAI advocates for consumers in post-purchase disputes using autonomous agents and the Model Context Protocol (MCP).

🚀 Quick Start

Get up and running in 5 minutes:

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

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

See QUICKSTART.md for detailed instructions.

📚 Documentation

Getting Started

• Quick Start Guide - Get running in 5 minutes
• Complete Setup Guide - Detailed setup instructions
• Project Overview - Architecture and features

Methodology & Vision

• AI-DLC Methodology - AI-Driven Development Life Cycle
• Traditional SDLC - SDLC vs AIDLC comparison
• GrappleAI Concept - Problem statement and vision
• AI-DLC Details - Active Defense Layer for Consumers

Component Documentation

• Frontend README - React app details
• Backend README - AWS CDK backend details

🏗️ Architecture

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

✨ Features

• Dispute Management - Create, track, and manage disputes
• Evidence Verification - Automatic confidence scoring and secure storage
• Autonomous Negotiation - AI-driven negotiation with sellers
• Consumer Rights - Consumer Protection Act 2019 integration
• Dashboard Analytics - Real-time dispute statistics
• Multi-language Support - Vernacular interface support

🛠️ Tech Stack

Frontend

• React 18 + TypeScript
• Vite (build tool)
• Tailwind CSS (styling)
• Zustand (state management)
• React Router (navigation)

Backend

• AWS CDK (infrastructure as code)
• AWS Lambda (serverless compute)
• AWS API Gateway (REST API)
• AWS DynamoDB (database)
• AWS S3 (storage)
• Node.js 20.x

📁 Project Structure

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

🚀 Getting Started

Prerequisites

• Node.js 18+
• AWS Account
• AWS CLI configured

Frontend Setup

cd app
npm install
npm run dev

Visit: http://localhost:5173

Backend Setup

cd backend
npm install
npm run cdk:deploy

Connect Frontend to Backend

Update app/.env.local:

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

📖 API Endpoints

Disputes

• POST /disputes - Create dispute
• GET /disputes - List disputes
• GET /disputes/{id} - Get dispute details
• PUT /disputes/{id} - Update dispute

Evidence

• POST /evidence/upload - Upload evidence
• GET /evidence/{id} - Get evidence
• POST /evidence/{id}/verify - Verify evidence

Negoti

... View full README on GitHub