first commit

2025-11-18 20:22:25 +03:30
commit 948238b6d9
55 changed files with 13772 additions and 0 deletions
@@ -0,0 +1,209 @@
+# PWA React App
+
+یک اپلیکیشن Progressive Web App (PWA) کامل و آماده تولید با React، TypeScript، و Supabase.
+
+## 🚀 ویژگی‌ها
+
+- ✅ **PWA** - قابل نصب و استفاده آفلاین
+- ✅ **React 18** با Vite
+- ✅ **TypeScript** برای نوع‌بندی کامل
+- ✅ **Tailwind CSS** برای استایل‌دهی
+- ✅ **shadcn/ui** برای کامپوننت‌های UI
+- ✅ **React Router** برای مسیریابی
+- ✅ **Jotai** برای مدیریت state سراسری
+- ✅ **Supabase** برای Backend، Auth و Database
+- ✅ **RTL Support** برای زبان فارسی
+- ✅ **IRANSans Font** به صورت پیش‌فرض
+- ✅ **Dark Mode Ready**
+
+## 📦 نصب
+
+```bash
+# نصب وابستگی‌ها
+npm install
+
+# یا با yarn
+yarn install
+
+# یا با pnpm
+pnpm install
+```
+
+## ⚙️ تنظیمات
+
+### 1. تنظیمات Supabase
+
+یک فایل `.env` در ریشه پروژه ایجاد کنید:
+
+```env
+VITE_SUPABASE_URL=your-supabase-project-url
+VITE_SUPABASE_ANON_KEY=your-supabase-anon-key
+```
+
+### 2. ساختار Database در Supabase
+
+پس از راه‌اندازی Supabase، جداول زیر را ایجاد کنید:
+
+#### جدول `requests`:
+```sql
+create table requests (
+  id uuid default gen_random_uuid() primary key,
+  user_id uuid references auth.users(id) on delete cascade not null,
+  title text not null,
+  description text not null,
+  status text default 'pending' check (status in ('pending', 'in_progress', 'completed')),
+  created_at timestamp with time zone default timezone('utc'::text, now()) not null,
+  updated_at timestamp with time zone default timezone('utc'::text, now()) not null
+);
+
+-- Enable RLS
+alter table requests enable row level security;
+
+-- Policy: Users can read all requests
+create policy "Anyone can view requests" on requests
+  for select using (true);
+
+-- Policy: Users can insert their own requests
+create policy "Users can insert their own requests" on requests
+  for insert with check (auth.uid() = user_id);
+
+-- Policy: Users can update their own requests
+create policy "Users can update their own requests" on requests
+  for update using (auth.uid() = user_id);
+```
+
+#### جدول `messages`:
+```sql
+create table messages (
+  id uuid default gen_random_uuid() primary key,
+  user_id uuid references auth.users(id) on delete cascade not null,
+  content text not null,
+  created_at timestamp with time zone default timezone('utc'::text, now()) not null
+);
+
+-- Enable RLS
+alter table messages enable row level security;
+
+-- Policy: Anyone can view messages
+create policy "Anyone can view messages" on messages
+  for select using (true);
+
+-- Policy: Authenticated users can insert messages
+create policy "Authenticated users can insert messages" on messages
+  for insert with check (auth.uid() = user_id);
+```
+
+#### فعال‌سازی Realtime:
+در Supabase Dashboard:
+1. به قسمت Database > Replication بروید
+2. Realtime را برای جداول `requests` و `messages` فعال کنید
+
+## 🏃 اجرا
+
+```bash
+# اجرای محیط توسعه
+npm run dev
+
+# ساخت نسخه production
+npm run build
+
+# پیش‌نمایش نسخه production
+npm run preview
+```
+
+## 📁 ساختار پروژه
+
+```
+src/
+├── assets/          # فایل‌های استاتیک
+├── components/      # کامپوننت‌های React
+│   └── ui/         # کامپوننت‌های shadcn/ui
+├── atoms/          # Jotai atoms برای state management
+├── hooks/          # Custom hooks
+├── utils/          # توابع کمکی
+├── services/       # سرویس‌های خارجی (Supabase)
+├── pages/          # صفحات اصلی
+│   ├── Main/
+│   ├── Account/
+│   ├── Request/
+│   ├── Chat/
+│   └── Auth/
+│       ├── Login/
+│       └── Signup/
+├── styles/         # فایل‌های CSS
+├── App.tsx         # کامپوننت اصلی
+└── main.tsx        # نقطه ورود
+```
+
+## 🔐 احراز هویت
+
+این اپلیکیشن از Supabase Auth پشتیبانی می‌کند:
+- **ورود با ایمیل/رمز عبور**
+- **ثبت نام با ایمیل**
+- **ورود با Google OAuth**
+- **ورود با شماره تلفن (OTP)**
+
+## 🎨 کامپوننت‌های UI
+
+از shadcn/ui استفاده شده است:
+- Button
+- Card
+- Input
+- Label
+- Toast
+- Avatar
+
+## 📱 PWA
+
+- Manifest برای نصب
+- Service Worker برای عملکرد آفلاین
+- Splash Screen
+- آیکون‌های مختلف اندازه
+
+## 🌐 پشتیبانی RTL
+
+- جهت RTL به صورت پیش‌فرض
+- فونت IRANSans
+- زبان فارسی
+
+## 📝 Scripts
+
+- `npm run dev` - اجرای محیط توسعه
+- `npm run build` - ساخت نسخه production
+- `npm run preview` - پیش‌نمایش نسخه production
+- `npm run lint` - بررسی کد با ESLint
+- `npm run format` - فرمت کد با Prettier
+
+## 🛠️ تکنولوژی‌ها
+
+- **React 18.2**
+- **TypeScript 5.2**
+- **Vite 5.0**
+- **React Router 6.21**
+- **Jotai 2.6**
+- **Supabase 2.39**
+- **Tailwind CSS 3.4**
+- **shadcn/ui**
+
+## 📄 لایسنس
+
+MIT
+
+## 🤝 مشارکت
+
+مشارکت‌ها خوش‌آمدند! لطفا ابتدا یک Issue ایجاد کنید.
+
+---
+
+ساخته شده با ❤️ توسط React و Vite
+
+
+
+
+
+
+
+
+
+
+