GrappleAI - 소비자를 위한 능동적 방어 계층

React 프론트엔드와 AWS CDK Lambda 백엔드로 구축된 AI 기반 분쟁 해결 플랫폼입니다. GrappleAI는 자율 에이전트와 MCP(Model Context Protocol)를 활용하여 소비자의 구매 후 분쟁을 대행합니다.

🚀 빠른 시작

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 지원

• 입력 검증

• 최소 권한 IAM 역할

• 저장 및 전송 중 암호화

• CORS 활성화

• API 속도 제한 지원

📈 성능

• 프론트엔드: 약 50KB gzip 압축

• Lambda: 512MB 메모리, 30초 제한 시간

• DynamoDB: 온디맨드 과금

• API: 100ms 미만 응답 시간

💰 비용 추정

월간 (소규모~중간 사용량):

• Lambda: 요청 100만 건당 $0.20

• DynamoDB: 쓰기 100단위당 $1.25

• S3: GB당 $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 - 소비자를 위한 능동적 방어 계층 인도 디지털 경제의 신뢰를 하나씩 구축합니다.