46 lines (36 loc) · 1 KB

Quick Setup Guide

Prerequisites

Node.js 18+ installed
npm 8+ installed

Installation (5 minutes)

Extract/Clone the project

git clone <repository-url>
cd payment-system

Install dependencies
```
npm run install:all
```

Start the system

# Terminal 1 - Backend
npm run dev:api

# Terminal 2 - Frontend  
npm run dev:web

Access the application
- Open browser: http://localhost:3000
- Backend API: http://localhost:3001

Demo Flow

Create a payment intent with any amount
Click "Confirm Payment"
Watch the 5 processing jobs execute in real-time
View the receipt and try creating a refund

Troubleshooting

Port conflicts: Kill processes using lsof -ti:3001 | xargs kill -9
Dependencies: Run npm run install:all again
Node version: Ensure Node.js 18+ with node --version

Architecture

Backend: Node.js + Express (port 3001)
Frontend: React + Vite (port 3000)