GrappleAI — Активный слой защиты для потребителей

Платформа для разрешения споров на основе ИИ, построенная с использованием React-фронтенда и AWS CDK Lambda-бэкенда. GrappleAI выступает за потребителей в спорах после покупки, используя автономных агентов и протокол контекста модели (MCP).

🚀 Быстрый старт

Запустите проект за 5 минут:

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

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

См. подробные инструкции в QUICKSTART.md.

Related MCP server: korean-privacy-law-mcp

📚 Документация

Начало работы

• Руководство по быстрому старту — Запуск за 5 минут

• Полное руководство по настройке — Подробные инструкции по установке

• Обзор проекта — Архитектура и возможности

Методология и видение

• Методология AI-DLC — Жизненный цикл разработки на основе ИИ

• Традиционный SDLC — Сравнение SDLC и AIDLC

• Концепция GrappleAI — Постановка задачи и видение

• Детали AI-DLC — Активный слой защиты для потребителей

Документация компонентов

• README фронтенда — Детали React-приложения

• README бэкенда — Детали AWS CDK бэкенда

🏗️ Архитектура

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

✨ Возможности

• Управление спорами — Создание, отслеживание и управление спорами

• Проверка доказательств — Автоматическая оценка достоверности и безопасное хранение

• Автономные переговоры — Ведение переговоров с продавцами на основе ИИ

• Права потребителей — Интеграция с Законом о защите прав потребителей 2019 года

• Аналитика на панели управления — Статистика по спорам в реальном времени

• Поддержка нескольких языков — Интерфейс на местных языках

🛠️ Технологический стек

Фронтенд

• React 18 + TypeScript

• Vite (инструмент сборки)

• Tailwind CSS (стилизация)

• Zustand (управление состоянием)

• React Router (навигация)

Бэкенд

• AWS CDK (инфраструктура как код)

• AWS Lambda (бессерверные вычисления)

• AWS API Gateway (REST API)

• AWS DynamoDB (база данных)

• AWS S3 (хранение)

• Node.js 20.x

📁 Структура проекта

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

🚀 Начало работы

Предварительные требования

• Node.js 18+

• Учетная запись AWS

• Настроенный AWS CLI

Настройка фронтенда

cd app
npm install
npm run dev

Перейдите: http://localhost:5173

Настройка бэкенда

cd backend
npm install
npm run cdk:deploy

Подключение фронтенда к бэкенду

Обновите app/.env.local:

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

📖 Конечные точки API

Споры

• POST /disputes — Создать спор

• GET /disputes — Список споров

• GET /disputes/{id} — Получить детали спора

• PUT /disputes/{id} — Обновить спор

Доказательства

• POST /evidence/upload — Загрузить доказательства

• GET /evidence/{id} — Получить доказательства

• POST /evidence/{id}/verify — Проверить доказательства

Переговоры

• POST /negotiation/initiate — Начать переговоры

• GET /negotiation/{txId} — Получить статус

🔧 Инструменты MCP-сервера

Бэкенд реализует следующие MCP-инструменты:

1. secureEvidence — Безопасное сохранение доказательств с оценкой достоверности

2. negotiateRefund — Запуск автономных переговоров

3. generateDisputeNotice — Создание официального уведомления о споре

4. verifyConsumerRights — Проверка прав по Закону о защите прав потребителей

📊 Возможности панели управления

• Статистика — Всего споров, разрешено, в процессе, процент успеха

• Список споров — Просмотр всех споров с индикаторами статуса

• Создать спор — Подача новых споров с доказательствами

• Обновления в реальном времени — Отслеживание прогресса спора

🔐 Безопасность

• Готовность к JWT/OAuth2

• Валидация входных данных

• Роли IAM с минимальными привилегиями

• Шифрование в покое и при передаче

• Включен CORS

• Готовность к ограничению частоты запросов API

📈 Производительность

• Фронтенд: ~50 КБ сжатых (gzip)

• Lambda: 512 МБ памяти, тайм-аут 30 с

• DynamoDB: тарификация по запросу

• API: время ответа <100 мс

💰 Оценка стоимости

Ежемесячно (при малом и среднем использовании):

• Lambda: $0.20 за 1 млн запросов

• DynamoDB: $1.25 за 100 единиц записи

• S3: $0.023 за ГБ

• API Gateway: $3.50 за 1 млн запросов

• Итого: ~$50–200 в месяц

🧪 Разработка

Команды фронтенда

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

Команды бэкенда

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

🚢 Развертывание

Фронтенд

• Vercel: vercel deploy

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

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

Бэкенд

cd backend
npm run cdk:deploy

📚 Дополнительная информация

• Документация AWS CDK

• Документация React

• Протокол контекста модели

• Закон о защите прав потребителей 2019 года

🤝 Участие в разработке

1. Создайте ветку с новой функциональностью

2. Внесите изменения

3. Запустите линтер и проверку типов

4. Отправьте PR

📄 Лицензия

MIT

🎯 Видение

GrappleAI создает слой доверия для цифровой экономики Индии. Объединяя ИИ, право и технологии, мы создаем активного защитника для каждого потребителя — гарантируя, что споры разрешаются справедливо, быстро и на предпочитаемом потребителем языке.

Готовы создавать? Начните с QUICKSTART.md!

GrappleAI — Активный слой защиты для потребителей Строим доверие в цифровой экономике Индии, один спор за раз.