paya-university-fault-system/docs/analysis/ui-wireframes.md

رابط کاربری و وایرفریم‌ها (UI Wireframes) – سامانه مدیریت و گزارش خرابی دانشگاهی

تهیه‌کننده: ارشیا همتی‌زاده
بازبین: رضا آدوسی
آخرین به‌روزرسانی: ۱۴۰۵/۰۸/۱۴

---

مقدمه

این سند فهرست صفحات، نقشهٔ ناوبری و طرح اولیهٔ چیدمان (Wireframe) رابط کاربری سامانه را ارائه می‌دهد. هدف، تبدیل داستان‌های کاربر و جریان‌های activity.md به صفحات مشخص است، پیش از انتخاب فناوری و شروع کدنویسی.

نکتهٔ نمایش: متن نهایی سامانه فارسی و راست‌به‌چپ (RTL) است. طرح‌های این سند با کاراکترهای ساده رسم شده‌اند و جهت چیدمان آن‌ها نمایندهٔ جهت نهایی نیست. در پیاده‌سازی، ستون «منو/اقدام» در سمت راست و ناحیهٔ محتوا در سمت چپ قرار می‌گیرد.

۱. اصول طراحی

#	اصل	توضیح	مستند مرجع
P1	راست‌به‌چپ و فارسی	همهٔ برچسب‌ها، پیام‌ها و تاریخ‌ها فارسی؛ تاریخ شمسی با ارقام فارسی	NFR-03، CONTRIBUTING.md §۷
P2	ناوبری نقش‌محور	هر کاربر فقط صفحات نقش خود را در منو می‌بیند	FR-02، US-15
P3	اعتبارسنجی درجا	خطا کنار همان فیلد نمایش داده می‌شود، نه در بالای صفحه	US-01.feature
P4	حفظ ورودی در خطا	در خطای اعتبارسنجی یا خطای سرور، مقادیر فرم پاک نمی‌شوند	US-01.feature
P5	افشا نکردن علت خطای ورود	پیام ورود مبهم است و فیلد اشتباه را مشخص نمی‌کند	US-15.feature
P6	پنهان‌نکردن قابلیت به‌جای کنترل دسترسی	مجوزدهی سمت سرور؛ رابط کاربری فقط بازتاب آن است	ADR-03 در software-architecture.md
P7	بازخورد صریح وضعیت	هر اقدام موفق یا ناموفق پیام روشن دارد	NFR-03
P8	نمایش وضعیت و اولویت به‌صورت بصری	بج رنگی برای وضعیت و اولویت در همهٔ فهرست‌ها	FR-08، US-06

۲. فهرست صفحات

شناسه	صفحه	نقش‌های مجاز	داستان‌های کاربر	جریان فعالیت
SCR-01	ورود به سامانه	همه	US-15	AD-01
SCR-02	گزارش‌های من	دانشجو، استاد	US-03	AD-02
SCR-03	ثبت گزارش خرابی	دانشجو، استاد	US-01، US-02	AD-02
SCR-04	جزئیات گزارش (نمای گزارش‌دهنده)	دانشجو، استاد	US-03، US-04، US-05	AD-02، AD-05
SCR-05	فهرست گزارش‌های باز	کارمند تأسیسات	US-06	AD-03
SCR-06	جزئیات گزارش (نمای تأسیسات)	کارمند تأسیسات	US-06–US-10	AD-03
SCR-07	مأموریت‌های من	تعمیرکار	US-11	AD-04
SCR-08	جزئیات مأموریت	تعمیرکار	US-12، US-13، US-14	AD-04
SCR-09	داشبورد مدیریتی	کارمند تأسیسات، مدیر	US-17	AD-03
SCR-10	اعلان‌ها	همه	US-16	—
SCR-11	خطای دسترسی	همه	US-15	AD-01
SCR-12	مودال تأیید/رد تعمیر	دانشجو، استاد	US-05	AD-05

۳. نقشهٔ ناوبری

flowchart TD
    LOGIN["SCR-01<br/>ورود"] --> ROLE{"نقش کاربر"}

    ROLE -->|"دانشجو / استاد"| R_HOME["SCR-02<br/>گزارش‌های من"]
    R_HOME --> R_NEW["SCR-03<br/>ثبت گزارش"]
    R_HOME --> R_DETAIL["SCR-04<br/>جزئیات گزارش"]
    R_DETAIL --> R_MODAL["SCR-12<br/>تأیید یا رد تعمیر"]

    ROLE -->|"کارمند تأسیسات"| F_HOME["SCR-05<br/>گزارش‌های باز"]
    F_HOME --> F_DETAIL["SCR-06<br/>جزئیات گزارش"]
    F_HOME --> F_DASH["SCR-09<br/>داشبورد"]

    ROLE -->|"تعمیرکار"| T_HOME["SCR-07<br/>مأموریت‌های من"]
    T_HOME --> T_DETAIL["SCR-08<br/>جزئیات مأموریت"]

    ROLE -->|"مدیر"| M_DASH["SCR-09<br/>داشبورد"]

    R_HOME -.-> NOTIF["SCR-10<br/>اعلان‌ها"]
    F_DETAIL -.-> NOTIF
    T_DETAIL -.-> NOTIF

    R_HOME -.->|"دسترسی غیرمجاز"| ERR["SCR-11<br/>خطای دسترسی"]
    F_HOME -.-> ERR
    T_HOME -.-> ERR

۴. وایرفریم‌ها

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

۴.۱. SCR-01 — ورود به سامانه

┌──────────────────────────────────────────────────────────────┐
│  [۱]                                                    [۲]  │
│                                                              │
│                  ┌────────────────────────┐                  │
│                  │        [۳]             │                  │
│                  │                        │                  │
│                  │  [۴]                   │                  │
│                  │  ┌──────────────────┐  │                  │
│                  │  │ [۵]              │  │                  │
│                  │  └──────────────────┘  │                  │
│                  │  [۶]                   │                  │
│                  │  ┌──────────────────┐  │                  │
│                  │  │ [۷]              │  │                  │
│                  │  └──────────────────┘  │                  │
│                  │  [۸]                   │                  │
│                  │  ┌──────────────────┐  │                  │
│                  │  │      [۹]         │  │                  │
│                  │  └──────────────────┘  │                  │
│                  └────────────────────────┘                  │
│                                                              │
└──────────────────────────────────────────────────────────────┘

#	عنصر	نوع	محتوا	رفتار	مرجع
۱	لوگو و نام سامانه	متن	«سامانه مدیریت و گزارش خرابی دانشگاهی»	—	README.md
۲	فضای خالی / زبان	—	فعلاً فقط فارسی	—	NFR-03
۳	عنوان فرم	تیتر	«ورود به سامانه»	—	US-15
۴	برچسب نام کاربری	متن	«نام کاربری»	—	FR-01
۵	ورودی نام کاربری	فیلد متنی	—	اجباری؛ در صورت خالی‌بودن: «این فیلد الزامی است» کنار فیلد	US-15.feature
۶	برچسب رمز عبور	متن	«رمز عبور»	—	FR-01
۷	ورودی رمز عبور	فیلد رمز	—	اجباری؛ ماسک‌شده	US-15.feature
۸	ناحیهٔ خطا	ناحیهٔ پیام	خالی در حالت عادی	در خطای ورود: «نام کاربری یا رمز عبور اشتباه است» — نام کاربری در فرم می‌ماند	US-15.feature
۹	دکمهٔ ورود	دکمهٔ اصلی	«ورود»	پس از موفقیت: انتقال به داشبورد نقش	AD-01

حالت‌های خطا:

حالت	پیام	رفتار	مرجع
فیلد خالی	«این فیلد الزامی است» (کنار همان فیلد)	ورود انجام نمی‌شود	US-15.feature
اعتبارنامهٔ نامعتبر	«نام کاربری یا رمز عبور اشتباه است»	نام کاربری حفظ می‌شود؛ فیلد اشتباه مشخص نمی‌شود	US-15.feature
سرویس احراز هویت در دسترس نیست	«خطا در ورود؛ لطفاً بعداً تلاش کنید»	ورود انجام نمی‌شود	US-15.feature

الزام امنیتی: هیچ پیام خطایی نباید مشخص کند «نام کاربری وجود ندارد» یا «رمز اشتباه است». تنها پیام مشترک مجاز است (P5).

۴.۲. SCR-03 — ثبت گزارش خرابی

┌──────────────────────────────────────────────────────────────┐
│  [۱]                                                    [۲]  │
├──────────────┬───────────────────────────────────────────────┤
│              │  [۳]                                          │
│   [M1]       │  ┌──────────────────────────────────────────┐ │
│   [M2]       │  │ [۴]                                      │ │
│   [M3]       │  │ ┌──────────────────────────────────────┐ │ │
│   [M4]       │  │ │ [۵]                                  │ │ │
│              │  │ └──────────────────────────────────────┘ │ │
│              │  │ [۶]                                      │ │
│              │  │ ┌──────────────────────────────────────┐ │ │
│              │  │ │ [۷]                                  │ │ │
│              │  │ │                                      │ │ │
│              │  │ └──────────────────────────────────────┘ │ │
│              │  │ [۸]                                      │ │ │
│              │  │ ┌──────────────────────────────────────┐ │ │
│              │  │ │ [۹]                                  │ │ │
│              │  │ └──────────────────────────────────────┘ │ │
│              │  │ [۱۰]                                     │ │ │
│              │  │ ┌──────────────────────────────────────┐ │ │
│              │  │ │ [۱۱]                                 │ │ │
│              │  │ └──────────────────────────────────────┘ │ │
│              │  │                          [۱۲]    [۱۳]    │ │
│              │  └──────────────────────────────────────────┘ │
└──────────────┴───────────────────────────────────────────────┘

#	عنصر	نوع	محتوا	رفتار	مرجع
۱	نوار بالا	ناحیه	نام کاربر + خروج	—	FR-01
۲	زنگ اعلان	آیکون + شمارنده	تعداد خوانده‌نشده	کلیک → SCR-10	US-16
M1–M4	منوی نقش	فهرست	«گزارش‌های من»، «ثبت گزارش»، «اعلان‌ها»، «خروج»	فقط آیتم‌های مجاز نقش	FR-02
۳	عنوان صفحه	تیتر	«ثبت گزارش خرابی»	—	US-01، US-02
۴	برچسب عنوان	متن	«عنوان» + نشان اجباری	—	FR-03
۵	ورودی عنوان	فیلد متنی	—	اجباری؛ حداکثر ۱۵۰ کاراکتر؛ شمارندهٔ کاراکتر	US-01.feature
۶	برچسب توضیحات	متن	«توضیحات» + نشان اجباری	—	FR-03
۷	ورودی توضیحات	ناحیهٔ متنی	—	اجباری	US-01.feature
۸	برچسب محل خرابی	متن	«محل خرابی» + نشان اجباری	—	FR-03
۹	ورودی محل	فیلد متنی	نمونه: «ساختمان الف - کلاس ۱۰۲»	اجباری	US-01.feature
۱۰	برچسب نوع تجهیز	متن	«نوع تجهیز» + نشان اجباری	—	FR-03
۱۱	انتخاب نوع تجهیز	فهرست کشویی	روشنایی، تهویه، آسانسور، برق، پروژکتور، سایر	اجباری	US-01.feature، README.md
۱۲	دکمهٔ انصراف	دکمهٔ ثانویه	«انصراف»	بازگشت به SCR-02	—
۱۳	دکمهٔ ثبت	دکمهٔ اصلی	«ثبت گزارش»	ارسال؛ در انتظار: غیرفعال + نشانگر	AD-02

حالت‌های نتیجه:

حالت	پیام	رفتار	مرجع
موفقیت	نمایش شناسهٔ یکتا	انتقال به SCR-04 یا ماندن با پیام موفقیت	US-01.feature
فیلد اجباری خالی	«این فیلد الزامی است» کنار فیلد	هیچ گزارشی ذخیره نمی‌شود	US-01.feature
عنوان ۱۵۱ کاراکتر	«حداکثر طول عنوان ۱۵۰ کاراکتر است»	هیچ گزارشی ذخیره نمی‌شود	US-01.feature
خطای سرور	«خطا در ثبت گزارش؛ لطفاً دوباره تلاش کنید»	مقادیر فرم حفظ می‌شوند، هیچ گزارش ناقصی ذخیره نمی‌شود	US-01.feature

الزام P4: در حالت خطای سرور، پاک‌کردن فرم ممنوع است. این رفتار در US-01.feature صریحاً الزام شده است.

۴.۳. SCR-05 — فهرست گزارش‌های باز (کارمند تأسیسات)

┌──────────────────────────────────────────────────────────────┐
│  [۱]                                                    [۲]  │
├──────────────┬───────────────────────────────────────────────┤
│              │  [۳]                                          │
│   [M1]       │  [۴]  [۵]  [۶]  [۷]                          │
│   [M2]       │  ┌──────────────────────────────────────────┐ │
│   [M3]       │  │ [۸] │ [۹] │ [۱۰] │ [۱۱] │ [۱۲] │ [۱۳]  │ │
│              │  ├──────────────────────────────────────────┤ │
│              │  │  ...                                     │ │
│              │  │  ...                                     │ │
│              │  │  ...                                     │ │
│              │  └──────────────────────────────────────────┘ │
│              │  [۱۴]                                         │
└──────────────┴───────────────────────────────────────────────┘

#	عنصر	نوع	محتوا	رفتار	مرجع
۱	نوار بالا	ناحیه	نام کاربر + خروج	—	—
۲	زنگ اعلان	آیکون	—	→ SCR-10	US-16
M1–M4	منوی نقش	فهرست	«گزارش‌های باز»، «داشبورد»، «اعلان‌ها»، «خروج»	—	FR-02
۳	عنوان صفحه	تیتر	«گزارش‌های باز»	—	US-06
۴	فیلتر وضعیت	کشویی چندگزینه	از report_statuses	پیش‌فرض: همه به‌جز «بسته‌شده»	FR-08، US-06
۵	فیلتر اولویت	کشویی چندگزینه	از priorities	—	FR-08
۶	جست‌وجو	فیلد متنی	جست‌وجو در عنوان و شناسه	—	FR-08
۷	دکمهٔ پاک‌کردن فیلتر	دکمهٔ ثانویه	«پاک‌کردن فیلترها»	بازنشانی	—
۸	ستون شناسه	ستون جدول	report_no	قابل مرتب‌سازی	—
۹	ستون عنوان	ستون جدول	عنوان گزارش	لینک به SCR-06	—
۱۰	ستون محل	ستون جدول	محل خرابی	—	FR-03
۱۱	ستون اولویت	ستون جدول	بج اولویت	رنگ‌بندی بر اساس سطح	FR-07
۱۲	ستون وضعیت	ستون جدول	بج وضعیت	رنگ‌بندی بر اساس وضعیت	FR-11
۱۳	ستون تاریخ	ستون جدول	تاریخ ثبت (شمسی)	مرتب‌سازی پیش‌فرض: نزولی	—
۱۴	صفحه‌بندی	ناحیه	تعداد در صفحه	—	NFR-04

تعریف «باز»: گزارشی که وضعیت آن «بسته‌شده» نیست. «باز» یک وضعیت رسمی نیست (data-model.md §۴.۲).

۴.۴. SCR-06 — جزئیات گزارش (نمای تأسیسات)

┌──────────────────────────────────────────────────────────────┐
│  [۱]                                                    [۲]  │
├──────────────┬───────────────────────────────────────────────┤
│   [M1]       │  [۳]  [۴]  [۵]                                │
│   [M2]       │  ┌──────────────────┬────────────────────────┐ │
│   [M3]       │  │ [۶]              │ [۷]                    │ │
│              │  │ [۸]              │ [۹]                    │ │
│              │  │ [۱۰]             │ [۱۱]                   │ │
│              │  │ [۱۲]             │ [۱۳]                   │ │
│              │  │                  │ [۱۴]                   │ │
│              │  │                  │ [۱۵]                   │ │
│              │  └──────────────────┴────────────────────────┘ │
│              │  [۱۶]                                         │
│              │  ┌──────────────────────────────────────────┐ │
│              │  │  ...                                     │ │
│              │  └──────────────────────────────────────────┘ │
└──────────────┴───────────────────────────────────────────────┘

#	عنصر	نوع	محتوا	رفتار	مرجع
۳	عنوان گزارش	تیتر	عنوان + شناسه	—	FR-03
۴	بج وضعیت	بج	وضعیت جاری	—	FR-11
۵	بج اولویت	بج	اولویت (در صورت تعیین)	—	FR-07
۶	توضیحات	متن	توضیحات گزارش‌دهنده	—	FR-03
۷	محل خرابی	متن	متن محل	—	FR-03
۸	نوع تجهیز	متن	برچسب فارسی نوع	—	FR-03
۹	گزارش‌دهنده	متن	نام نمایشی + نقش	—	—
۱۰	تاریخ ثبت	متن	تاریخ شمسی	—	—
۱۱	اطلاعات تکمیلی	فهرست	متن/تصویر + ارائه‌دهنده + زمان	—	FR-04، US-04
۱۲	نتیجهٔ تعمیر	ناحیه	توضیحات + تعمیرکار + زمان	فقط در صورت وجود	FR-12
۱۳	تعیین اولویت	کشویی + دکمه	«ذخیرهٔ اولویت»	فقط نقش تأسیسات	FR-07، US-07
۱۴	تخصیص تعمیرکار	کشویی + دکمه	فهرست تعمیرکاران + «تخصیص»	فقط نقش تأسیسات	FR-09، US-08
۱۵	تغییر وضعیت	کشویی + دکمه	فقط انتقال‌های مجاز	گزینه‌های غیرمجاز نمایش داده نمی‌شوند	FR-11، US-09
۱۶	تاریخچه	تایم‌لاین	فهرست اقدامات به ترتیب زمانی	—	FR-16، US-10

الزام ADR-06: گزینه‌های کشویی «تغییر وضعیت» باید از جدول انتقال‌های مجاز خوانده شوند، نه از کد. انتقال‌های نامشخص (پرسش‌های باز ۶ و ۷) نباید در رابط کاربری ظاهر شوند تا زمانی که تیم تصمیم بگیرد.

۴.۵. SCR-07 — مأموریت‌های من (تعمیرکار)

┌──────────────────────────────────────────────────────────────┐
│  [۱]                                                    [۲]  │
├──────────────┬───────────────────────────────────────────────┤
│   [M1]       │  [۳]                                          │
│   [M2]       │  ┌──────────────────────────────────────────┐ │
│              │  │ [۴] │ [۵] │ [۶] │ [۷] │ [۸] │ [۹]     │ │
│              │  ├──────────────────────────────────────────┤ │
│              │  │  ...                                     │ │
│              │  └──────────────────────────────────────────┘ │
└──────────────┴───────────────────────────────────────────────┘

#	عنصر	نوع	محتوا	رفتار	مرجع
۳	عنوان صفحه	تیتر	«مأموریت‌های من»	—	US-11
۴	ستون شناسه	ستون	report_no	—	—
۵	ستون عنوان	ستون	عنوان گزارش	لینک به SCR-08	—
۶	ستون محل	ستون	محل خرابی	—	—
۷	ستون اولویت	ستون	بج اولویت	—	FR-07
۸	ستون وضعیت	ستون	وضعیت تخصیص	—	US-12، US-13
۹	ستون زمان تخصیص	ستون	تاریخ شمسی	—	—

واژه‌شناسی: «مأموریت» در US-11 و AD-04 همان «تخصیص» در FR-09 است. رابط کاربری از واژهٔ «مأموریت» استفاده می‌کند چون زبان تعمیرکار است.

۴.۶. SCR-08 — جزئیات مأموریت (تعمیرکار)

┌──────────────────────────────────────────────────────────────┐
│  [۱]                                                    [۲]  │
├──────────────┬───────────────────────────────────────────────┤
│   [M1]       │  [۳]  [۴]                                     │
│              │  ┌──────────────────────────────────────────┐ │
│              │  │ [۵]  [۶]  [۷]                            │ │
│              │  └──────────────────────────────────────────┘ │
│              │  [۸]                                          │
│              │  ┌──────────────────────────────────────────┐ │
│              │  │ [۹]                                      │ │
│              │  └──────────────────────────────────────────┘ │
│              │  [۱۰]  [۱۱]  [۱۲]                            │
│              │  [۱۳]                                         │
│              │  ┌──────────────────────────────────────────┐ │
│              │  │  ...                                     │ │
│              │  └──────────────────────────────────────────┘ │
└──────────────┴───────────────────────────────────────────────┘

#	عنصر	نوع	محتوا	رفتار	مرجع
۳	عنوان + شناسه	تیتر	—	—	—
۴	بج وضعیت	بج	—	—	FR-11
۵	توضیحات خرابی	متن	—	—	FR-03
۶	محل خرابی	متن	—	—	—
۷	نوع تجهیز	متن	—	—	—
۸	دکمهٔ «شروع تعمیر»	دکمه	فقط در وضعیت «ارجاع‌شده»	تغییر وضعیت به «در حال تعمیر»	US-12
۹	فرم ثبت نتیجه	ناحیهٔ متنی + دکمه	توضیحات اقدامات	فقط پس از شروع تعمیر	FR-12، US-13
۱۰	دکمهٔ «ثبت نتیجه»	دکمهٔ اصلی	—	تغییر وضعیت به «تعمیر انجام‌شده»	US-13
۱۱	دکمهٔ «درخواست اطلاعات»	دکمهٔ ثانویه	—	باز شدن فرم درخواست	FR-13، US-14
۱۲	فرم درخواست اطلاعات	ناحیهٔ متنی + دکمه	متن درخواست	ارسال به گزارش‌دهنده	US-14، AD-04
۱۳	تاریخچه	تایم‌لاین	—	—	FR-16

پرسش باز ۶: مکانیزم دقیق «انتظار برای دریافت اطلاعات» در AD-04 علامت‌گذاری شده است. آیا وضعیت گزارش باید تغییر کند؟ تا تصمیم‌گیری، رابط کاربری فقط نشانگر «در انتظار پاسخ» نمایش می‌دهد و وضعیت گزارش را تغییر نمی‌دهد.

۴.۷. SCR-09 — داشبورد مدیریتی

┌──────────────────────────────────────────────────────────────┐
│  [۱]                                                    [۲]  │
├──────────────┬───────────────────────────────────────────────┤
│   [M1]       │  [۳]                                          │
│   [M2]       │  ┌───────────┬───────────┬───────────┐        │
│              │  │    [۴]    │    [۵]    │    [۶]    │        │
│              │  └───────────┴───────────┴───────────┘        │
│              │  [۷]                                          │
│              │  ┌──────────────────────────────────────────┐ │
│              │  │ [۸]                                      │ │
│              │  └──────────────────────────────────────────┘ │
└──────────────┴───────────────────────────────────────────────┘

#	عنصر	نوع	محتوا	مرجع
۳	عنوان	تیتر	«داشبورد»	US-17
۴	کارت آمار	کارت	تعداد گزارش‌های باز	FR-17
۵	کارت آمار	کارت	تعداد درخواست‌های فوری	FR-17، US-17
۶	کارت آمار	کارت	تعداد کل گزارش‌ها	FR-17
۷	نمودار / فهرست	ناحیه	توزیع گزارش‌ها بر اساس وضعیت	FR-17
۸	فهرست کوتاه	جدول	آخرین گزارش‌های فوری	US-17

تفکیک نقش: مدیر فقط مشاهده دارد (FR-17، US-17). کارمند تأسیسات علاوه بر داشبورد به SCR-05 و SCR-06 هم دسترسی دارد. سطح دسترسی کامل مدیر پرسش باز ۹ در activity.md است.

۴.۸. SCR-12 — مودال تأیید یا رد تعمیر

┌──────────────────────────────────────────────────────────────┐
│                        [۱]                                   │
│  ┌────────────────────────────────────────────────────────┐  │
│  │ [۲]                                                    │  │
│  │ [۳]                                                    │  │
│  │ ┌────────────────────────────────────────────────────┐ │  │
│  │ │ [۴]                                                │ │  │
│  │ └────────────────────────────────────────────────────┘ │  │
│  │ [۵]                                                    │  │
│  │                          [۶]        [۷]                │  │
│  └────────────────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────────────────┘

#	عنصر	نوع	محتوا	رفتار	مرجع
۱	پوشش پس‌زمینه	لایه	—	کلیک بیرون: بستن مودال	—
۲	عنوان مودال	تیتر	«تأیید یا رد تعمیر»	—	US-05
۳	نتیجهٔ تعمیر	متن	توضیحات ثبت‌شده	—	FR-12
۴	دلیل رد	ناحیهٔ متنی	فقط اگر «رد» انتخاب شود	اجباری در حالت رد	US-05.feature
۵	ناحیهٔ خطا	پیام	—	«ذکر دلیل رد الزامی است»	US-05.feature
۶	دکمهٔ تأیید	دکمهٔ اصلی	«تأیید تکمیل تعمیر»	بستن گزارش	FR-14
۷	دکمهٔ رد	دکمهٔ خطر	«رد تعمیر»	ثبت رد + پیگیری	US-05.feature

حالت‌های خطا:

حالت	پیام	رفتار	مرجع
رد بدون دلیل	«ذکر دلیل رد الزامی است»	وضعیت بدون تغییر می‌ماند	US-05.feature
کاربر غیرمجاز	«دسترسی مجاز نیست»	وضعیت بدون تغییر	US-05.feature
وضعیت نامناسب	«این گزارش در وضعیت قابل تأیید نیست»	عملیات انجام نمی‌شود	US-05.feature
کلیک دوباره	—	فقط یک تغییر وضعیت و یک ورودی تاریخچه	US-05.feature

۵. اجزای مشترک (Component Inventory)

شناسه	جزء	توضیح	استفاده در	مرجع
CMP-01	بج وضعیت	نمایش label_fa با رنگ متناظر	SCR-02، SCR-04، SCR-05، SCR-06، SCR-07	FR-11
CMP-02	بج اولویت	نمایش label_fa با رنگ متناظر	SCR-05، SCR-06، SCR-07	FR-07
CMP-03	جدول داده	ستون‌بندی، مرتب‌سازی، صفحه‌بندی	SCR-02، SCR-05، SCR-07	NFR-04
CMP-04	فیلد فرم با اعتبارسنجی	برچسب + نشان اجباری + پیام خطای درجا	SCR-01، SCR-03، SCR-12	US-01.feature
CMP-05	تایم‌لاین تاریخچه	فهرست رویدادهای report_history	SCR-04، SCR-06، SCR-08	FR-16
CMP-06	آپلود تصویر	انتخاب و پیش‌نمایش تصویر	SCR-04	FR-04
CMP-07	زنگ اعلان	شمارندهٔ خوانده‌نشده + لینک به SCR-10	همهٔ صفحات داخلی	US-16
CMP-08	نوار پیام	پیام موفقیت/خطای سطح صفحه	همهٔ صفحات	NFR-03
CMP-09	منوی نقش‌محور	آیتم‌های منو بر اساس نقش	همهٔ صفحات داخلی	FR-02
CMP-10	کادر تأیید	برای اقدام‌های برگشت‌ناپذیر (بستن گزارش)	SCR-12	US-05

۶. قرارداد رنگی (پیشنهادی)

رنگ‌ها پیشنهادی هستند و باید با پرسش باز ۲۴ تأیید شوند.

وضعیت / اولویت	رنگ پیشنهادی	توضیح
ثبت‌شده	خاکستری	تازه ثبت شده، هنوز بررسی نشده
ارجاع‌شده	آبی	در انتظار شروع تعمیر
در حال تعمیر	نارنجی	در جریان
تعمیر انجام‌شده	سبز روشن	در انتظار بازخورد گزارش‌دهنده
بسته‌شده	سبز تیره	پایان یافته
اولویت کم	خاکستری	—
اولویت متوسط	آبی	—
اولویت زیاد	نارنجی	—
اولویت فوری	قرمز	باید در داشبورد برجسته شود (US-17)

الزام دسترس‌پذیری: رنگ نباید تنها حامل معنا باشد؛ متن برچسب همیشه در کنار رنگ نمایش داده می‌شود.

۷. پیام‌های استاندارد رابط کاربری

این جدول، متن دقیق پیام‌ها را از فایل‌های Feature استخراج کرده تا در پیاده‌سازی، متن تغییر نکند:

شناسه	متن پیام	شرایط	مرجع
MSG-01	«این فیلد الزامی است»	فیلد اجباری خالی	US-01.feature، US-15.feature
MSG-02	«حداکثر طول عنوان ۱۵۰ کاراکتر است»	عنوان بیش از ۱۵۰ کاراکتر	US-01.feature
MSG-03	«خطا در ثبت گزارش؛ لطفاً دوباره تلاش کنید»	خطای سرور در ذخیره	US-01.feature
MSG-04	«نام کاربری یا رمز عبور اشتباه است»	اعتبارنامهٔ نامعتبر	US-15.feature
MSG-05	«خطا در ورود؛ لطفاً بعداً تلاش کنید»	سرویس احراز هویت در دسترس نیست	US-15.feature
MSG-06	«دسترسی مجاز نیست»	تلاش برای دسترسی غیرمجاز	US-15.feature، US-05.feature
MSG-07	«ذکر دلیل رد الزامی است»	رد تعمیر بدون دلیل	US-05.feature
MSG-08	«این گزارش در وضعیت قابل تأیید نیست»	تأیید در وضعیت نامناسب	US-05.feature

۸. نکات و پرسش‌های باز

#	پرسش	اثر
۲۳	فناوری و فریم‌ورک رابط کاربری چیست؟	تعیین روش پیاده‌سازی همهٔ صفحات
۲۴	پالت رنگی و هویت بصری دانشگاه چیست؟	بخش ۶ موقت است
۲۵	آیا رابط کاربری باید واکنش‌گرا (موبایل) باشد؟	در NFR-03 صریح نیست؛ بر چیدمان جدول‌ها اثر دارد
۲۶	سطح دسترسی دقیق مدیر (پرسش باز ۹ در activity.md) چیست؟	تعیین آیتم‌های منوی مدیر
۲۷	آیا گزارش‌دهنده می‌تواند در هر زمان اطلاعات تکمیلی اضافه کند یا فقط پس از درخواست؟	رفتار دکمهٔ «افزودن اطلاعات» در SCR-04
۲۸	کانال اعلان (پرسش باز ۸) چیست؟	محتوای SCR-10 و CMP-07
۲۹	آیا صفحهٔ «پروفایل کاربر» یا «تغییر رمز» لازم است؟	در مستندات نیامده
۳۰	آیا گزارش‌دهنده می‌تواند گزارش خود را ویرایش یا لغو کند؟	در مستندات نیامده

پرسش ۲۷ مهم است: AD-02 این را به‌عنوان نکتهٔ مدل‌سازی علامت زده و US-04 زمان آن را محدود نکرده است. تا تصمیم‌گیری، رابط کاربری دکمهٔ «افزودن اطلاعات» را فقط پس از درخواست نمایش می‌دهد (محافظه‌کارانه‌ترین حالت).

---

وضعیت سند: نسخه اولیه (Draft) – آماده بازبینی