طراحی و پیاده‌سازی پلتفرم تأمین مالی جمعی و مدیریت تعاونی

# عنوان پروژه: طراحی و پیاده‌سازی پلتفرم تأمین مالی جمعی و مدیریت تعاونی "هاوکار" (فول‌استک) ## 1. معرفی و هدف پروژه ما قصد داریم پلتفرمی به نام **"هاوکار" (Hawkar)** راه‌اندازی کنیم. این پروژه یک سیستم **Crowdfunding (تأمین مالی جمعی)** با هدف اجتماعی و اقتصادی در شهر بانه است. هدف اصلی جمع‌آوری سرمایه‌های خرد مردمی برای راه‌اندازی کارگاه‌های تولیدی و جایگزینی شغل کولبری با اشتغال پایدار است. ما به یک برنامه‌نویس فول‌استک (یا تیم) نیاز داریم تا صفر تا صد این پروژه (فرانت‌‌اند، بک‌‌اند، دیتابیس و پنل مدیریت) را پیاده‌سازی کند. --- ## 2. تکنولوژی‌های مورد نیاز (Tech Stack) * **زبان برنامه‌نویسی و فریم‌ورک:** انتخاب با شماست. (پیشنهاد ما Node.js/Express یا Python/Django یا PHP/Laravel است). لطفاً در پیشنهاد خود تکنولوژی انتخابی را ذکر کنید. * **دیتابیس:** SQL (مثل PostgreSQL/MySQL) یا NoSQL (مثل MongoDB) بسته به معماری پیشنهادی شما. * **فرانت‌‌اند:** ترجیحاً React.js یا Vue.js (به صورت SPA). دیزاین باید ریسپانسیو، مدرن و کاربرپسند باشد. * **زبان‌های سیستم:** سیستم باید **دو زبانه** (فارسی و کردی سورانی) باشد و از **RTL** به طور کامل پشتیبانی کند. --- ## 3. امکانات و ماژول‌های مورد نیاز ### الف) بخش کاربری (User Dashboard) هر کاربر پس از ثبت‌نام باید به یک پنل دسترسی داشته باشد که شامل موارد زیر است: 1. **احراز هویت (Auth):** * ثبت‌نام و ورود با شماره موبایل (OTP) یا ایمیل/رمز عبور. * بازیابی رمز عبور. 2. **کیف پول (Wallet):** * مشاهده موجودی لحظه‌ای. * افزایش موجودی: اتصال به درگاه پرداخت اینترنتی + امکان آپلود فیش واریزی (کارت به کارت) جهت تایید دستی توسط ادمین. * درخواست برداشت وجه. * لیست تراکنش‌ها (واریز، برداشت، سود واریزی، پاداش دعوت). 3. **احراز هویت تکمیلی (KYC):** * فرمی برای دریافت اطلاعات هویتی (کد ملی، شبا، آدرس و...). * آپلود تصویر کارت ملی و عکس پرسنلی. * نمایش وضعیت تایید هویت (در انتظار، تایید شده، رد شده). 4. **استخدام و رزومه (Job Profile):** * یک فرم چند مرحله‌ای (Wizard) برای کاربرانی که متقاضی کار در کارگاه‌ها هستند. * شامل: اطلاعات تحصیلی، سابقه کار، مهارت‌ها، وضعیت جسمانی و... 5. **سیستم دعوت (Referral):** * تولید کد دعوت اختصاصی برای هر کاربر. * محاسبه پاداش برای معرف پس از اولین تراکنش موفق کاربر دعوت شده. 6. **پشتیبانی (Ticketing):** * ارسال تیکت به مدیریت و دریافت پاسخ (همراه با قابلیت آپلود عکس). 7. **نظرسنجی (Polling):** * شرکت در نظرسنجی‌های عمومی (مثلاً انتخاب پروژه بعدی برای ساخت). ### ب) پنل مدیریت (Admin Panel) ادمین باید دسترسی کامل به مدیریت سیستم داشته باشد: 1. **داشبورد آماری:** مشاهده تعداد کاربران، کل سرمایه جذب شده، نمودار رشد، تیکت‌های باز و... 2. **مدیریت کاربران:** * لیست کاربران، جستجو، فیلتر، تغییر نقش کاربر (مثلاً ارتقا به مدیر کارگاه)، مسدود کردن کاربر. * مشاهده و تایید/رد مدارک احراز هویت (KYC). 3. **مدیریت مالی:** * تایید یا رد فیش‌های واریزی دستی. * تایید درخواست‌های برداشت وجه. * **توزیع سود:** امکانی که ادمین مبلغ سود کل ماهانه یک پروژه را وارد کند و سیستم به صورت خودکار بر اساس میزان سرمایه هر کاربر، سود را محاسبه و به کیف پول آن‌ها واریز کند. * ثبت گزارش‌های شفافیت مالی (درآمد و هزینه ماهانه) برای نمایش در سایت. 4. **مدیریت محتوا (CMS):** * مدیریت اسلایدر صفحه اصلی. * افزودن/ویرایش/حذف اخبار و اطلاعیه‌ها. * مدیریت پروژه‌ها (پروژه‌های در حال تامین مالی و پروژه‌های آتی) همراه با نوار پیشرفت درصد تامین سرمایه. * مدیریت نقشه راه (Roadmap). * مدیریت اعضای تیم و بخش "درباره ما". 5. **مدیریت نظرسنجی‌ها:** ایجاد سوال و گزینه‌ها و مشاهده نتایج. ### ج) بخش عمومی سایت (Public Pages) 1. **صفحه اصلی:** شامل اسلایدر، معرفی پروژه‌ها، نوار اعلانات زنده (مثلاً: "علی م. 500 هزار تومان سرمایه‌گذاری کرد")، آمار کلی پروژه. 2. **صفحات داخلی:** درباره ما، تماس با ما، اخبار، قوانین و مجوزها. 3. **صفحه شفافیت مالی:** نمایش نمودار درآمد/هزینه پروژه به صورت عمومی. 4. **ماشین حساب سود:** ابزاری که کاربر مبلغ و مدت زمان را وارد کند و سود تقریبی را ببیند. --- ## 4. نیازمندی‌های غیرکارکردی (مهم) 1. **امنیت:** رمزنگاری پسوردها، جلوگیری از SQL Injection و XSS، استفاده از توکن (JWT) برای احراز هویت. 2. **پرفورمنس:** کدنویسی بهینه برای هندل کردن تعداد بالای کاربران. 3. **معماری:** کد باید تمیز (Clean Code) و قابل توسعه باشد. دیتابیس باید نرمال‌سازی شده باشد. --- ## 5. خروجی مورد انتظار 1. سورس کد کامل پروژه (فرانت و بک). 2. دیتابیس اسکیما (یا خروجی SQL). 3. داکیومنت نصب و راه‌اندازی (Deployment Guide) روی سرور لینوکس. 4. پشتیبانی اولیه (مثلاً 1 ماه) برای رفع باگ‌های احتمالی. --- **نکته:** دیزاین اولیه (UI) به صورت فایل‌های React موجود است که می‌توانم در اختیار شما قرار دهم تا الگوی کار باشد، اما پیاده‌سازی منطق و اتصال به بک‌‌اند با شماست.