در این تسک، اطلاعات موردنیاز برای ایجاد و ثبت آموزشگاه‌ها از فایل Excel یا CSV دریافت و به دیتابیس سایت آموزشگاه‌یاب منتقل خواهد شد.
اطلاعات انتقالی باید شامل تمامی فیلدهای اجباری و اختیاری فرم پروفایل و فرم برندینگ آموزشگاه باشد و برای هر آموزشگاه یک کاربر رندوم ایجاد شود.
همچنین دوره، زیر‌دوره، استان و شهرهای درج‌شده در فایل باید پیش از انتقال اطلاعات در دیتابیس سایت وجود داشته باشند تا ارتباط اطلاعات آموزشگاه‌ها با داده‌های پایه به‌درستی برقرار شود.
هرگونه مشکل، مغایرت یا نقص موجود در فایل Excel / CSV از سمت داده‌های ورودی، بر عهده کارفرما خواهد بود.
الزامات تسک
-
دریافت اطلاعات آموزشگاه‌ها از فایل Excel یا CSV.
-
انتقال تمامی اطلاعات موردنیاز برای ساخت آموزشگاه‌ها به دیتابیس.
-
انتقال فیلدهای اجباری فرم پروفایل آموزشگاه.
-
انتقال فیلدهای اختیاری فرم پروفایل آموزشگاه.
-
انتقال فیلدهای موردنیاز فرم برندینگ آموزشگاه.
-
ایجاد یک User رندوم برای هر آموزشگاه.
-
اطمینان از وجود موارد زیر در دیتابیس پیش از ثبت آموزشگاه‌ها:
-
تطبیق اطلاعات دوره و زیر‌دوره موجود در فایل با داده‌های موجود در دیتابیس.
-
تطبیق استان و شهرهای موجود در فایل با داده‌های دیتابیس.
-
برقراری ارتباط صحیح اطلاعات آموزشگاه با دوره، زیر‌دوره، استان و شهر مربوطه.
-
جلوگیری از ایجاد داده‌های تکراری در فرآیند انتقال.
-
هرگونه مشکل، نقص، مغایرت یا ایراد در اطلاعات موجود در فایل Excel / CSV بر عهده کارفرما خواهد بود.
وظایف اجرایی
-
بررسی ساختار فایل Excel / CSV ورودی.
-
بررسی ستون‌ها و فیلدهای موردنیاز برای ساخت آموزشگاه.
-
تطبیق فیلدهای فایل با ساختار دیتابیس و فرم‌های پروفایل و برندینگ.
-
بررسی وجود دوره‌ها و زیر‌دوره‌های درج‌شده در فایل در دیتابیس.
-
بررسی وجود استان‌ها و شهرهای درج‌شده در فایل در دیتابیس.
-
آماده‌سازی داده‌ها برای ورود به دیتابیس.
-
ایجاد User رندوم برای هر آموزشگاه.
-
ثبت اطلاعات پروفایل هر آموزشگاه.
-
ثبت اطلاعات برندینگ هر آموزشگاه.
-
ایجاد ارتباط صحیح آموزشگاه با دوره، زیر‌دوره، استان و شهر.
-
انتقال نهایی داده‌ها به دیتابیس.
-
بررسی صحت اطلاعات پس از انتقال.
-
بررسی تعداد آموزشگاه‌های ایجادشده و تطبیق آن با اطلاعات فایل ورودی.
-
بررسی خطاهای احتمالی ناشی از ساختار یا محتوای فایل.
خروجی نهایی
-
انتقال اطلاعات آموزشگاه‌ها از فایل Excel / CSV به دیتابیس سایت آموزشگاه‌یاب.
-
ایجاد آموزشگاه‌ها بر اساس فیلدهای اجباری و اختیاری فرم پروفایل و برندینگ.
-
ایجاد User رندوم برای هر آموزشگاه.
-
ثبت و ارتباط صحیح دوره، زیر‌دوره، استان و شهر برای آموزشگاه‌ها.
-
تکمیل فرآیند انتقال و آماده‌سازی اطلاعات آموزشگاه‌ها برای استفاده در سایت آموزشگاه‌یاب.
-
صحت‌سنجی داده‌های منتقل‌شده و تطبیق آن با فایل ورودی.
دستورالعمل جامع تحویل تسک‌ها و چرخه حیات توسعه (Definition of Done)
در فرآیند ثبت و اجرای تمامی تسک‌ها، رعایت اصول زیر الزامی است (بسته به ماهیت و دامنه هر تسک/سرویس، برخی جزئیات ممکن است کم یا زیاد شوند):
محیط و مخزن تحویل: شروع، توسعه و تحویل کار باید منحصراً روی گیت‌هاب (GitHub)، در مخزن اختصاصی پروژه و برنچ تعیین‌شده (Feature Branch یا برنچ موظف طبق ساختار GitFlow) انجام پذیرد.
استقرار نسخه آزمایشی (Staging): پس از اتمام توسعه اولیه، نسخه کاندید جهت انجام تست‌های پذیرش (Acceptance / Smoke Tests) بر روی محیط استقرار موقت (Staging / Development Server) دیپلوی شود.
معیارهای پذیرش کیفی، امنیتی و پایش:
تکمیل و به‌روزرسانی فایل README.md مخزن شامل راهنمای اجرا، تست و متغیرها.
پاس شدن کامل گیت‌های کیفی (Quality Gates) شامل بررسی استانداردهای کد، Linting و تحلیل ایستا (Static Analysis).
رفع کامل آسیب‌پذیری‌ها و خطاهای امنیتی (Security Gates) در ابزارهای پویش سورس و وابستگی‌ها.
یکپارچه‌سازی و اتصال بدون خطای سرویس به ابزار رصد خطا (Sentry Integration) برای لاگین و ترکینگ دقیق رویدادهای بحرانی.
تست‌نویسی کامل بر اساس متدولوژی TDD با پوشش کد بالا (حداکثر پوشش ممکن / ۱۰۰٪ در بخش‌های منطق تجاری حیاتی).
ادغام کد (Merge to Main): تنها پس از تأیید ناظر/تیم فنی و موفقیت تمام خطوط لوله یکپارچه‌سازی مداوم (CI/CD)، درخواست ادغام (Pull Request) به برنچ main اعمال شود.
آنالیز و رفع عیوب پس از ادغام (Post-Merge Analysis): پس از ادغام، رفتارهای سیستم، گزارش‌های لاگ و نتایج مانیتورینگ مورد ارزیابی قرار گرفته و هرگونه رگرسیون یا باگ کشف‌شده سریعاً رفع گردد.