اتصال پروژه maarij به سامانه پژوهشی

۱. اطلاعات عمومی اتصال

از داشبورد Supabase پروژه maarij را باز کنید. نشانی پروژه را از بخش Connect یا تنظیمات API و کلید Publishable را از بخش API Keys بردارید.

۲. ساخت دیتابیس

1. از لینک «SQL Editor» بالا وارد شوید و New query را بزنید.
2. در بسته، فایل supabase/migrations/202610200001_maarij.sql را با یک ویرایشگر متن باز کنید.
3. تمام متن آن را در SQL Editor کپی و Run کنید.
4. در Table Editor جدول‌های maarij_state، maarij_members، maarij_records، maarij_events، maarij_files و maarij_profiles ایجاد می‌شوند. داده‌های اولیه نمایشی ندارند.
5. در Storage، مخزن maarij-private باید Private باشد.

۳. انتشار بخش سرور

1. در Edge Functions، گزینه ساخت تابع جدید با Editor را انتخاب کنید.
2. نام تابع دقیقاً maarij-api باشد.
3. تمام محتوای فایل supabase/functions/maarij-api/index.ts را جایگزین کد پیش‌فرض کنید؛ این فایل کامل و یکپارچه است.
4. تابع را Deploy کنید. در تنظیمات همان تابع گزینه بررسی JWT در درگاه را خاموش کنید؛ علت این است که صفحه عمومی هم از همین مسیر استفاده می‌کند. خود کد، توکن همه مسیرهای خصوصی را با Supabase Auth بررسی می‌کند.
5. در Secrets، مقدار MAARIJ_OWNER_EMAIL را برابر ایمیل واقعی مدیرکل قرار دهید.
6. مقدار MAARIJ_ALLOWED_ORIGINS را برابر نشانی دقیق سایت، بدون اسلش پایانی قرار دهید؛ برای چند نشانی از کامای انگلیسی استفاده کنید.
7. SUPABASE_URL و SUPABASE_SERVICE_ROLE_KEY در محیط میزبانی توابع Supabase از پیش فراهم‌اند؛ آن‌ها را به فایل config.js منتقل نکنید.

۴. انتشار صفحات سایت

1. فایل config.js دانلودشده را جایگزین web/config.js کنید.
2. وارد Cloudflare شوید و در Workers & Pages یک Pages با Direct Upload ایجاد کنید.
3. فقط محتویات پوشه web را بارگذاری کنید؛ index.html باید در ریشه فایل‌های منتشرشده باشد.
4. نشانی pages.dev را که دریافت می‌کنید در MAARIJ_ALLOWED_ORIGINS مرحله قبل وارد و ذخیره کنید.
5. در Supabase → Authentication → URL Configuration، مقدار Site URL و Redirect URLs را برابر آدرس کامل سایت قرار دهید. برای بازگشت ورود، نشانی ریشه با اسلش پایانی را هم مجاز کنید.

۵. تنظیم ورود و ارسال ایمیل

ورود این نسخه با ایمیل و رمز عبور و، در صورت تنظیم، گوگل انجام می‌شود. ایمیل تماس پروفایل اختیاری است، اما حساب ورود ایمیلی به ایمیل نیاز دارد. پیامک تا اتصال پنل غیرفعال است.

برای ثبت‌نام و دعوت افراد خارج از اعضای تیم پروژه، SMTP اختصاصی را در Authentication → Email / SMTP تنظیم کنید. سرویس ایمیل پیش‌فرض Supabase محدود به آدرس‌های مجاز تیم و محدودیت ارسال است؛ برای تست عمومی به آن تکیه نکنید. تأیید ایمیل را برای راه‌اندازی واقعی روشن نگه دارید و حداقل طول رمز را ۱۰ بگذارید.

برای گوگل: ارائه‌دهنده Google را در تنظیمات Authentication فعال کنید، Client ID و Client Secret را همان‌جا بگذارید و آدرس callback نمایش‌داده‌شده را در Google Cloud ثبت کنید؛ سپس گزینه گوگل را در سازنده config.js فعال و سایت را دوباره منتشر کنید.

۶. اولین ورود و تست واقعی

1. در صفحه سایت، «ایجاد حساب مدیرکل» را بزنید و همان ایمیلی را استفاده کنید که در MAARIJ_OWNER_EMAIL ثبت کرده‌اید.
2. ایمیل را تأیید و از بخش مدیریت وارد شوید. اگر از قبل حساب Supabase Auth با همین ایمیل دارید، مستقیماً ورود مدیریت را انجام دهید.
3. پژوهشکده‌ها، مجله‌ها، بانک‌ها، حساب مقصد و تعرفه‌ها را ثبت کنید. سه فرم را بازبینی و انتشارشان را تأیید کنید.
4. پژوهشگر و ارزیاب با دو حساب جدا ثبت‌نام و ایمیل خود را تأیید کنند؛ مدیر در اعضا آن‌ها را فعال کند.
5. هر دو، پروفایل هویتی و بانکی را تکمیل کنند؛ اثر با فایل واقعی ارسال شود.
6. مدیر دریافت، بررسی اجمالی، هزینه، فیش و ارجاع را انجام دهد؛ ارزیاب فرم را کامل و ارسال کند.
7. اصلاحات را ابلاغ، نسخه دوم را ارسال و نتیجه نهایی را ثبت کنید. محرمانگی فایل‌ها را با حساب‌های مختلف بسنجید.

فرم‌های ارزیابی این نسخه

مقاله: ۳۳ معیار با متن و سقف امتیاز فایل شما، در ۷ بخش با مجموع ۱۰۰. معیارهای کیفی، نقاط قوت و ضعف، اصلاحات، نظر پنج‌گانه و نام و زمان ثبت ارزیاب هم وجود دارند. فرم کتاب و طرح با همین ساختار و معیارهای متناسب ساخته شده‌اند.

بلی امتیاز کامل معیار و خیر صفر دارد. بازه «۱ تا ۵۹» فایل مبنا در نرم‌افزار به «۰ تا ۵۹» کامل شده تا نمره صفر نیز پوشش داده شود. نظر متفاوت با بازه، نیازمند توضیح است. ثبت با حساب کاربری امضای دیجیتال گواهی‌شده نیست.

پشتیبان و محدودیت‌ها

خروجی داده‌ها در پنل، اطلاعات پژوهشی و پروفایل را شامل می‌شود؛ بایت فایل‌ها و کاربران Auth داخل آن نیستند. بکاپ SQL و Storage را جداگانه بگیرید. دستور بکاپ دیتابیس در README آمده است.

این نسخه برای شروع آزمایش آنلاین ساخته شده است. پرداخت بانکی، پیامک، اسکن بدافزار و امضای گواهی‌شده تا اتصال سرویس، فعال نیستند. دیتابیس از تراکنش مقایسه نسخه استفاده می‌کند؛ ظرفیت فعلی موتور تا ۵۰۰۰ رکورد کاری، ۱۰۰۰ عضو و ۵۰۰ فایل است و برای حجم سازمانی بالاتر به بهینه‌سازی ذخیره‌سازی نیاز دارد.