GrappleAI - 消費者のためのアクティブ防御レイヤー

ReactフロントエンドとAWS CDK Lambdaバックエンドで構築されたAI駆動の紛争解決プラットフォーム。GrappleAIは、自律エージェントとModel Context Protocol (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方法論 - AI駆動開発ライフサイクル

• 従来の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

✨️ 機能

• 紛争管理 - 紛争の作成、追跡、管理

• 証拠検証 - 自動信頼スコアリングと安全なストレジ

• 自律交渉 - AI駆動の売り手との交渉

• 消費者権利 - 消費者保護法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 ready

• 入力検証

• 最小権限のIAMロール

• 保存時および転送時の暗号化

• CORS有効

• APIレート制限対応

📈 パフォーマンス

• フロントエンド: ~50KB gzipped

• Lambda: 512MBメモリ、30秒タイムアウト* DynamoDB: オンデマンド課金

• API: 応答時間100ms未満

💰 コスト見積もり

月間（小〜中規模利用）:

• Lambda: 100万リクエストあたり$0.20

• DynamoDB: 100書き込みユニットあたり$1.25

• S3: 1GBあたり$0.023

• API Gateway: 100万リクエストあたり$3.50

• 合計: ~$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ドキュメント

• Model Context Protocol

• 消費者保護法2019

🤝 コントリビューション

1. フィーチャーブランチを作成

2. 変更を加える

3. リンターとタイプチェックを実行

4. PRを提出

📄 ライセンス

MIT

🎯 ビジョン

GrappleAIは、インドのデジタル経済のための信頼レイヤーを構築しています。AI、法律、テクノロジーを組み合わせることで、すべての消費者に能動的な擁護者を生み出し、紛争が公正かつ迅速に、消費者の希望する言語で解決されるようにしています。

構築の準備はできましたか？ QUICKSTART.mdから始めましょう！

GrappleAI - 消費者のためのアクティブ防御レイヤー インドのデジタル経済に信頼を築く、一つの紛争から。