New_Micro_Learning/docs/manager-phase-2-report.md

3.8 KiB
خام سرزنش تاریخچه

گزارش اجرای فاز ۲ پنل مدیر

تاریخ اجرا: ۱۴۰۵/۰۵/۲۹ (2026-08-20)

محدوده اجراشده

  • صفحه «تیم من» به فهرست عملیاتی اعضای تیم تبدیل شد.
  • جست‌وجو روی نام، ایمیل، واحد و سمت اضافه شد.
  • فیلتر تیم، وضعیت معنایی عضو و وضعیت یادگیری اضافه شد.
  • جدول دسکتاپ شامل کارمند، سمت/واحد، دوره فعال، درصد تکمیل، موعد نزدیک، معوق، آخرین فعالیت و وضعیت است.
  • در عرض ۹۰۰ پیکسل و کمتر، جدول به کارت‌های responsive تبدیل می‌شود.
  • وضعیت‌ها با متن و آیکن نمایش داده می‌شوند و تنها به رنگ وابسته نیستند: در مسیر، نیازمند توجه، عقب‌افتاده و غیرفعال.
  • پروفایل یادگیری عضو با URL قابل deep-link (member و tab) اضافه شد.
  • بخش‌های دارای داده معتبر پروفایل شامل نمای کلی، یادگیری فعال، تکمیل‌شده‌ها، ارزیابی‌ها، مسیرهای یادگیری و فعالیت اخیر است.
  • داده پروفایل از پاسخ تجمیعی و team-scoped موجود ساخته می‌شود؛ درخواست جداگانه به ازای هر عضو ایجاد نشده است.

امنیت و حریم خصوصی

  • قرارداد API تغییر نکرد و همچنان فقط GET /api/v1/manager/workspace مصرف می‌شود.
  • تست backend اکنون نبود عضو، رویداد و نتیجه ارزیابی تیم دیگر را صریح‌تر کنترل می‌کند.
  • اطلاعات منابع انسانی نامرتبط نمایش داده نمی‌شود؛ فقط مشخصات لازم برای زمینه یادگیری استفاده شده است.
  • عملیات Assign Learning، Send Reminder و Extend deadline اضافه نشدند، چون permission و endpoint آن‌ها متعلق به فاز ۳ است.
  • Skills و Certificates نمایش داده نشدند، چون در قرارداد فعلی داده معتبر و مجاز برای آن‌ها وجود ندارد.

تصمیم‌های UI/UX

  • طراحی با tokenهای فعلی پروژه، RTL، dark mode و زبان انگلیسی سازگار نگه داشته شد.
  • کنترل‌های تعاملی حداقل ۴۴ پیکسل، label قابل‌مشاهده و focus state دارند.
  • تب‌های پروفایل wrap می‌شوند و در موبایل به grid تبدیل می‌شوند تا اسکرول افقی ایجاد نشود.
  • بر اساس QA واقعی، breakpoint کارت‌ها از ۷۰۰ به ۹۰۰ پیکسل افزایش یافت تا layout تبلت کنار sidebar بدون overflow باشد.
  • motion محدود است و prefers-reduced-motion رعایت می‌شود.

تست و راستی‌آزمایی

  • Frontend unit: ۳۰ فایل، ۹۵ تست پاس.
  • Backend: ۱۵۸ تست، ۱۰۶۸ assertion پاس.
  • تست هدفمند Manager frontend: ۴ تست پاس.
  • تست هدفمند Manager backend: ۳ تست، ۲۴ assertion پاس.
  • lint، typecheck، Pint و build production پاس.
  • Playwright Phase 2 در Chrome پاس؛ عرض‌های ۳۷۵، ۷۶۸ و ۱۴۴۰ پیکسل بدون overflow بررسی شدند.
  • build همچنان هشدار قبلی chunkهای بزرگ‌تر از ۵۰۰ کیلوبایت را دارد؛ این هشدار از محدوده فاز ۲ مستقل است.

خارج از محدوده این فاز

  • تخصیص دوره/مسیر و deadline
  • ارسال reminder و notification action
  • تمدید deadline
  • ثبت و نمایش skill/certificate بدون منبع داده معتبر
  • قابلیت‌های فازهای ۳ به بعد