Setup Guide

Is guide se aap Mobile Shop Management System locally run kar sakte hain.

Prerequisites

• Node.js 18+ installed
• npm ya yarn
• Supabase free account (supabase.com)

Step 1: Project Clone / Open

cd Mobil-Shop-System
npm install

Step 2: Supabase Project Banana

1. Supabase Dashboard par jao
2. New Project create karo
3. Project name aur database password set karo
4. Project ready hone ka wait karo

Step 3: Database Schema Run Karna

1. Supabase Dashboard → SQL Editor
2. supabase/complete-schema.sql file kholo
3. Poora SQL copy karke SQL Editor mein paste karo
4. Run karo

Yeh automatically create karega:

• Saari tables (users, products, sales, etc.)
• Functions (login, password update)
• Triggers (auto stock update)
• RLS policies
• Default admin user

Step 4: Environment Variables

Project root mein .env.local file banao:

NEXT_PUBLIC_SUPABASE_URL=https://your-project-id.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key_here

Values kahan se milengi:

• Supabase Dashboard → Project Settings → API
• Project URL → NEXT_PUBLIC_SUPABASE_URL
• anon public key → NEXT_PUBLIC_SUPABASE_ANON_KEY

.env.example file bhi project mein hai reference ke liye.

Step 5: Development Server

npm run dev

Browser mein kholo: http://localhost:3000

Step 6: Login

Default credentials:

Username: admin
Password: admin123

Login ke baad Dashboard khulega.

Production Build

npm run build
npm start

Common Issues

"Invalid username or password"

• Confirm karo complete-schema.sql run hua hai
• Supabase SQL Editor mein check karo: SELECT * FROM users;
• Admin user exist karta hai ya nahi

Supabase connection error

• .env.local values sahi hain ya nahi verify karo
• URL https:// se start honi chahiye
• Anon key JWT format mein honi chahiye (eyJ...)

Activity logs nahi dikh rahe

• activity_logs table schema se create honi chahiye
• Browser console mein errors check karo

Stock update nahi ho raha

• update_stock_on_sale trigger schema mein hona chahiye
• Sale complete hone ke baad sale_items insert hona chahiye

Scripts