Karzar (WIP) 🗳️

سامانه کمپین‌های جمع‌سپاری و کارزارهای آنلاین — وضعیت: در حال توسعه و هنوز وارد فاز پروداکشن نشده است.

این پروژه یک وب‌اپلیکیشن با Next.js و TypeScript برای ایجاد و مدیریت کارزارهای اجتماعی/مدنی است؛ شامل صفحات ساخت کمپین، امضا/حمایت، به‌روزرسانی‌ها و پروفایل کاربر. «این مخزن هنوز کامل نیست و آماده استفاده در محیط تولیدی نمی‌باشد.»

🌐 نسخه آزمایشی: https://karzar-nine.vercel.app

✨ ویژگی‌ها (در حال توسعه)

• Next.js App Router با معماری مدرن و SSR/ISR
• UI با Tailwind CSS و کامپوننت‌های سفارشی
• مدل داده کمپین/امضا/به‌روزرسانی‌ها (در حال تکمیل)
• احراز هویت و پروفایل کاربر (WIP)
• صفحات عمومی کمپین + لیست‌بندی و جست‌وجو (WIP)

توجه: بسیاری از بخش‌ها در حال توسعه‌اند و API/Schema ممکن است تغییر کند؛ برای محیط تولیدی استفاده نشود.

🏗️ ساختار پروژه

.
├── public/                 # دارایی‌های استاتیک
├── src/
│   ├── app/                # مسیرها، صفحات، API Routes
│   ├── components/         # اجزای UI قابل استفاده مجدد
│   ├── views/              # صفحات سطح بالا (Campaign, Home, etc.)
│   ├── utils/              # توابع کمکی
│   ├── types/              # تایپ‌ها و اینترفیس‌ها
│   └── data/               # داده‌های نمونه/ثابت
├── next.config.ts
├── tailwind.config.ts
├── package.json
└── README.md

🚧 وضعیت پروژه

• WIP: هنوز در فاز MVP و پیش‌نمایش است.
• برخی صفحات و APIها ناقص‌اند یا Mock شده‌اند.
• طراحی پایگاه داده و احراز هویت در حال نهایی‌سازی است.

🧩 نقشه راه

• تکمیل مدل داده کمپین‌ها (Campaign, Signature, Update, Category)
• احراز هویت (NextAuth یا Auth Provider دیگر)
• پنل ساخت/مدیریت کمپین (Dashboard)
• سئو و متادیتا برای اشتراک‌گذاری شبکه‌های اجتماعی
• جست‌وجو و فیلتر پیشرفته کمپین‌ها
• سیستم دیدگاه‌ها و به‌روزرسانی‌های صاحب کمپین
• ایمیل/نوتیفیکیشن برای امضاکنندگان
• بهینه‌سازی عملکرد و دسترس‌پذیری (A11y)
• Dockerfile/Compose برای استقرار

⚙️ نصب و راه‌اندازی (Dev)

پیش‌نیازها

• Node.js 18+
• pnpm
• (اختیاری) پایگاه داده (PostgreSQL/SQLite) — در حال حاضر صفحات ممکن است از داده Mock استفاده کنند

نصب

pnpm install

تنظیم محیط

یک فایل .env بسازید (نمونه):

# DATABASE_URL=postgresql://user:pass@localhost:5432/karzar
# NEXTAUTH_SECRET=...

اجرای توسعه

pnpm dev

🧠 معماری منطقی

• Pages & API Routes در Next.js (App Router)
• Domain: مدیریت کمپین‌ها، امضاها، و به‌روزرسانی‌ها
• Data: لایه داده (در حال طراحی) و داده‌های نمونه برای توسعه

🔒 ملاحظات امنیتی

• این پروژه Production-ready نیست؛ الزامات امنیتی (Auth, Rate Limiting, Validation) باید قبل از انتشار پیاده‌سازی شود.

وضعیت: پروژه هنوز کامل نشده و آماده استفاده در محیط تولیدی نیست؛ تغییرات شکستن‌دار ممکن است رخ دهد.