From 11d08a4471573ee76ad1fb8193fb07105e83cc31 Mon Sep 17 00:00:00 2001
From: Reza Adousi <91836545+RezaAdousi@users.noreply.github.com>
Date: Mon, 9 Nov 2026 23:20:00 +0330
Subject: [PATCH] Add initial UI wireframes for university fault management
 system

---
 docs/design/ui-wireframes.md | 393 +++++++++++++++++++++++++++++++++++
 1 file changed, 393 insertions(+)
 create mode 100644 docs/design/ui-wireframes.md

diff --git a/docs/design/ui-wireframes.md b/docs/design/ui-wireframes.md
new file mode 100644
index 0000000..ddd4d09
--- /dev/null
+++ b/docs/design/ui-wireframes.md
@@ -0,0 +1,393 @@
+# طرح اولیه رابط کاربری (UI Wireframes) – سامانه مدیریت و گزارش خرابی دانشگاهی
+
+**تهیه‌کننده:** رضا آدوسی  
+**بازبین:** ارشیا همتی‌زاده  
+**آخرین به‌روزرسانی:** ۱۴۰۵/۰۸/۱۸  
+**وضعیت سند:** نسخه اولیه (Draft) – آماده بازبینی
+
+---
+
+## ۱. مقدمه
+
+هدف این سند، ارائه طرح اولیه رابط کاربری سامانه مدیریت و گزارش خرابی دانشگاهی (پایا) است. در این طراحی، صفحات اصلی سامانه، اطلاعات قابل مشاهده، ورودی‌های موردنیاز کاربر و پاسخ سیستم به عملیات مختلف مشخص می‌شوند.
+
+تمرکز این مرحله بر روشن بودن مسیر انجام کارها و تعامل کاربران با سامانه است، نه طراحی گرافیکی نهایی. جزئیات ظاهری مانند رنگ‌بندی، فونت و تصاویر در مراحل بعدی توسعه تعیین خواهند شد.
+
+## ۲. نقش‌های کاربری
+
+رابط کاربری سامانه با توجه به نقش و سطح دسترسی کاربران، بخش‌های متفاوتی را نمایش می‌دهد.
+
+| نقش کاربر | وظایف اصلی در سامانه |
+|---|---|
+| دانشجو | ثبت خرابی، مشاهده و پیگیری گزارش‌ها |
+| استاد | ثبت خرابی، مشاهده و پیگیری گزارش‌ها |
+| کارمند تأسیسات | بررسی گزارش‌ها، تعیین اولویت و ارجاع به تعمیرکار |
+| تعمیرکار | مشاهده وظایف ارجاع‌شده، به‌روزرسانی وضعیت و ثبت نتیجه تعمیر |
+| مدیر | مشاهده وضعیت کلی گزارش‌ها و اطلاعات مدیریتی |
+
+## ۳. صفحات اصلی سامانه
+
+### ۳.۱. صفحه ورود (Login)
+
+**کاربران:** تمام نقش‌ها
+
+هدف این صفحه احراز هویت کاربران و ورود به بخش متناسب با سطح دسترسی آن‌هاست.
+
+**طرح اولیه:**
+
+```text
++------------------------------------------+
+|            سامانه پایا                   |
+|    سامانه مدیریت و گزارش خرابی دانشگاه   |
+|                                          |
+|       نام کاربری: [________________]     |
+|                                          |
+|       رمز عبور:   [________________]     |
+|                                          |
+|              [ ورود ]                   |
+|                                          |
+|  پیام خطا:                               |
+|  اطلاعات ورود نامعتبر است.               |
++------------------------------------------+
+```
+
+**ورودی‌ها:**
+- نام کاربری
+- رمز عبور
+
+**عملیات و پاسخ سیستم:**
+- با وارد کردن اطلاعات معتبر، کاربر وارد داشبورد متناسب با نقش خود می‌شود.
+- در صورت اشتباه بودن اطلاعات، پیام خطای مناسب نمایش داده می‌شود.
+- در صورت خالی بودن فیلدهای ضروری، از ارسال فرم جلوگیری می‌شود.
+
+### ۳.۲. داشبورد دانشجو و استاد
+
+**کاربران:** دانشجو، استاد
+
+این صفحه نقطه شروع فعالیت گزارش‌دهندگان پس از ورود به سامانه است.
+
+**طرح اولیه:**
+
+```text
++------------------------------------------------+
+| سامانه پایا                 [نام کاربر] [خروج] |
++------------------------------------------------+
+| منوی اصلی                                      |
+|                                                |
+| [داشبورد]  [ثبت گزارش خرابی]  [گزارش‌های من]  |
++------------------------------------------------+
+| داشبورد                                        |
+|                                                |
+| تعداد گزارش‌های ثبت‌شده:  5                    |
+| گزارش‌های در حال بررسی:   2                    |
+| گزارش‌های در حال تعمیر:   1                    |
+| گزارش‌های تکمیل‌شده:      2                    |
+|                                                |
+| آخرین گزارش‌ها:                                |
+| +------+-------------+-------------+---------+ |
+| | کد   | عنوان       | تاریخ       | وضعیت  | |
+| +------+-------------+-------------+---------+ |
+| | 101  | خرابی پروژکتور| ۱۴۰۵/۰۸/۱۰| در حال بررسی | |
+| | 102  | مشکل روشنایی | ۱۴۰۵/۰۸/۱۱| در حال تعمیر | |
+| +------+-------------+-------------+---------+ |
+|                                                |
+|           [ ثبت گزارش جدید ]                   |
++------------------------------------------------+
+```
+
+**اطلاعات قابل مشاهده:**
+- تعداد گزارش‌های ثبت‌شده توسط کاربر
+- تعداد گزارش‌ها بر اساس وضعیت
+- فهرست آخرین گزارش‌ها
+- شناسه، عنوان، تاریخ و وضعیت هر گزارش
+
+**عملیات:**
+- ورود به صفحه ثبت گزارش جدید
+- مشاهده فهرست گزارش‌های قبلی
+- مشاهده جزئیات و وضعیت هر گزارش
+
+### ۳.۳. صفحه ثبت گزارش خرابی (Create Fault Report)
+
+**کاربران:** دانشجو، استاد
+
+در این صفحه کاربر اطلاعات مربوط به خرابی را وارد و گزارش خود را ثبت می‌کند.
+
+**طرح اولیه:**
+
+```text
++------------------------------------------------+
+| ثبت گزارش خرابی                                |
++------------------------------------------------+
+| عنوان خرابی:                                   |
+| [________________________________________]     |
+|                                                |
+| توضیحات:                                       |
+| [________________________________________]     |
+| [________________________________________]     |
+|                                                |
+| محل وقوع خرابی:                                |
+| [________________________________________]     |
+|                                                |
+| نوع خرابی:                                     |
+| [ انتخاب نوع خرابی                  ▼ ]        |
+|                                                |
+| اطلاعات تکمیلی / تصویر (اختیاری):              |
+| [ انتخاب فایل ]                                |
+|                                                |
+|             [ ثبت گزارش ]                      |
+|             [ انصراف ]                          |
++------------------------------------------------+
+```
+
+**ورودی‌ها:**
+- عنوان خرابی
+- توضیحات خرابی
+- محل وقوع خرابی
+- نوع خرابی
+- فایل یا تصویر مرتبط (اختیاری)
+
+**عملیات و پاسخ سیستم:**
+- پس از تکمیل اطلاعات ضروری، کاربر با انتخاب «ثبت گزارش» درخواست خود را ارسال می‌کند.
+- سیستم اطلاعات را اعتبارسنجی و گزارش را ذخیره می‌کند.
+- در صورت ثبت موفق، پیام تأیید همراه با شناسه گزارش نمایش داده می‌شود.
+- در صورت ناقص بودن اطلاعات ضروری، پیام خطای مرتبط نمایش داده می‌شود.
+
+**نمونه پیام موفقیت:**
+
+```text
+گزارش خرابی با موفقیت ثبت شد.
+شناسه گزارش: 103
+وضعیت: ثبت‌شده
+```
+
+### ۳.۴. صفحه فهرست و جزئیات گزارش‌ها
+
+**کاربران:** دانشجو، استاد، کارمند تأسیسات، مدیر
+
+این صفحه برای مشاهده گزارش‌ها و بررسی وضعیت آن‌ها استفاده می‌شود. اطلاعات و عملیات قابل دسترس با توجه به نقش کاربر متفاوت خواهد بود.
+
+**طرح اولیه فهرست گزارش‌ها:**
+
+```text
++------------------------------------------------+
+| گزارش‌های خرابی                                |
++------------------------------------------------+
+| جست‌وجو: [____________________]                |
+| وضعیت:   [همه وضعیت‌ها             ▼]          |
+|                                                |
+| +------+-------------+-------------+----------+|
+| | کد   | عنوان       | محل         | وضعیت   ||
+| +------+-------------+-------------+----------+|
+| | 101  | خرابی پروژکتور| کلاس ۱۰۱  | ثبت‌شده  ||
+| | 102  | مشکل روشنایی | راهرو      | در حال تعمیر||
+| | 103  | خرابی کولر   | کلاس ۲۰۲  | در حال بررسی||
+| +------+-------------+-------------+----------+|
+|                                                |
+|       [ مشاهده جزئیات گزارش ]                  |
++------------------------------------------------+
+```
+
+**اطلاعات قابل مشاهده در صفحه جزئیات:**
+- شناسه گزارش
+- عنوان و توضیحات خرابی
+- محل وقوع
+- تاریخ ثبت
+- وضعیت فعلی
+- اولویت (در صورت تعیین)
+- مسئول رسیدگی (در صورت ارجاع)
+- سوابق تغییر وضعیت و اقدامات انجام‌شده
+
+**عملیات:**
+- جست‌وجو و فیلتر گزارش‌ها
+- مشاهده جزئیات گزارش
+- مشاهده تاریخچه تغییرات، متناسب با سطح دسترسی کاربر
+
+### ۳.۵. داشبورد کارمند تأسیسات
+
+**کاربر:** کارمند تأسیسات
+
+این صفحه برای بررسی گزارش‌های ثبت‌شده، تعیین اولویت و ارجاع آن‌ها به تعمیرکار طراحی می‌شود.
+
+**طرح اولیه:**
+
+```text
++------------------------------------------------+
+| داشبورد کارمند تأسیسات       [نام کاربر] [خروج]|
++------------------------------------------------+
+| [گزارش‌های جدید] [در حال بررسی] [ارجاع‌شده]    |
++------------------------------------------------+
+| گزارش‌های نیازمند بررسی                        |
+|                                                |
+| +------+-------------+------------+-----------+|
+| | کد   | عنوان       | محل        | اولویت   ||
+| +------+-------------+------------+-----------+|
+| | 101  | خرابی پروژکتور| کلاس ۱۰۱ | تعیین‌نشده||
+| | 103  | خرابی کولر  | کلاس ۲۰۲  | تعیین‌نشده||
+| +------+-------------+------------+-----------+|
+|                                                |
+|             [ بررسی گزارش ]                    |
++------------------------------------------------+
+```
+
+**عملیات در صفحه بررسی گزارش:**
+- مشاهده اطلاعات گزارش
+- تعیین اولویت گزارش
+- ثبت توضیحات یا درخواست اطلاعات تکمیلی
+- انتخاب تعمیرکار و ارجاع گزارش
+- مشاهده وضعیت گزارش‌های قبلی
+
+**پاسخ سیستم:**
+- پس از تعیین اولویت، اطلاعات گزارش به‌روزرسانی می‌شود.
+- پس از ارجاع موفق، گزارش به فهرست وظایف تعمیرکار اضافه می‌شود.
+- در صورت نامعتبر بودن ارجاع یا انتخاب نکردن تعمیرکار، پیام خطا نمایش داده می‌شود.
+
+### ۳.۶. داشبورد تعمیرکار
+
+**کاربر:** تعمیرکار
+
+تعمیرکار از این صفحه برای مشاهده وظایف ارجاع‌شده و ثبت پیشرفت کار استفاده می‌کند.
+
+**طرح اولیه:**
+
+```text
++------------------------------------------------+
+| داشبورد تعمیرکار             [نام کاربر] [خروج]|
++------------------------------------------------+
+| وظایف ارجاع‌شده                                |
+|                                                |
+| +------+-------------+------------+-----------+|
+| | کد   | عنوان       | محل        | وضعیت    ||
+| +------+-------------+------------+-----------+|
+| | 101  | خرابی پروژکتور| کلاس ۱۰۱ | ارجاع‌شده||
+| | 102  | مشکل روشنایی | راهرو     | در حال تعمیر||
+| +------+-------------+------------+-----------+|
+|                                                |
+|             [ مشاهده وظیفه ]                   |
++------------------------------------------------+
+```
+
+**عملیات در صفحه جزئیات وظیفه:**
+- مشاهده توضیحات و محل خرابی
+- مشاهده اولویت تعیین‌شده
+- تغییر وضعیت کار
+- ثبت توضیحات مربوط به روند تعمیر
+- ثبت نتیجه نهایی تعمیر
+
+**نمونه فرم ثبت نتیجه:**
+
+```text
++------------------------------------------------+
+| ثبت نتیجه تعمیر                                |
++------------------------------------------------+
+| گزارش شماره: 101                               |
+|                                                |
+| وضعیت جدید: [تکمیل‌شده               ▼]        |
+|                                                |
+| توضیحات اقدامات انجام‌شده:                     |
+| [________________________________________]     |
+| [________________________________________]     |
+|                                                |
+|             [ ثبت نتیجه ]                      |
++------------------------------------------------+
+```
+
+**پاسخ سیستم:**
+- پس از ثبت موفق، وضعیت گزارش به‌روزرسانی می‌شود.
+- نتیجه تعمیر در سوابق گزارش ذخیره می‌شود.
+- در صورت ناموفق بودن عملیات، پیام خطا نمایش داده می‌شود.
+
+### ۳.۷. داشبورد مدیر
+
+**کاربر:** مدیر
+
+این صفحه برای مشاهده وضعیت کلی سامانه و نظارت بر گزارش‌های خرابی طراحی می‌شود.
+
+**طرح اولیه:**
+
+```text
++------------------------------------------------+
+| داشبورد مدیریتی              [نام کاربر] [خروج]|
++------------------------------------------------+
+| گزارش‌های ثبت‌شده:       120                   |
+| گزارش‌های در حال بررسی:  15                    |
+| گزارش‌های در حال تعمیر:  20                    |
+| گزارش‌های تکمیل‌شده:     85                    |
++------------------------------------------------+
+|                                                |
+| گزارش‌ها بر اساس وضعیت                         |
+|                                                |
+| [نمایش نمودار یا آمار خلاصه]                   |
+|                                                |
+| آخرین گزارش‌های ثبت‌شده                        |
+| [مشاهده فهرست گزارش‌ها]                        |
++------------------------------------------------+
+```
+
+**اطلاعات قابل مشاهده:**
+- تعداد کل گزارش‌ها
+- تعداد گزارش‌ها بر اساس وضعیت
+- آمار کلی عملکرد سامانه
+- آخرین گزارش‌های ثبت‌شده
+
+**عملیات:**
+- مشاهده گزارش‌های کلی
+- بررسی وضعیت گزارش‌ها
+- دسترسی به اطلاعات مدیریتی متناسب با سطح دسترسی
+
+## ۴. سناریوی کامل تعامل کاربر با سامانه
+
+برای بررسی ارتباط صفحات و روشن شدن جریان اطلاعات، سناریوی زیر در نظر گرفته شده است.
+
+**سناریو: ثبت و پیگیری خرابی پروژکتور توسط دانشجو**
+
+۱. دانشجو وارد صفحه ورود می‌شود و اطلاعات حساب کاربری خود را وارد می‌کند.
+
+۲. پس از ورود موفق، داشبورد دانشجو نمایش داده می‌شود.
+
+۳. دانشجو گزینه «ثبت گزارش خرابی» را انتخاب می‌کند.
+
+۴. عنوان، توضیحات و محل وقوع خرابی را وارد کرده و گزارش را ثبت می‌کند.
+
+۵. سیستم اطلاعات را اعتبارسنجی می‌کند. در صورت معتبر بودن، گزارش ذخیره شده و یک شناسه یکتا به آن اختصاص داده می‌شود.
+
+۶. کارمند تأسیسات گزارش جدید را در فهرست گزارش‌های نیازمند بررسی مشاهده می‌کند.
+
+۷. کارمند تأسیسات گزارش را بررسی کرده، اولویت آن را تعیین و به یک تعمیرکار ارجاع می‌دهد.
+
+۸. تعمیرکار گزارش را در فهرست وظایف خود مشاهده کرده و پس از شروع کار، وضعیت آن را به‌روزرسانی می‌کند.
+
+۹. پس از انجام تعمیر، تعمیرکار نتیجه اقدامات را ثبت می‌کند.
+
+۱۰. دانشجو می‌تواند با مراجعه به فهرست گزارش‌های خود، وضعیت و نتیجه تعمیر را مشاهده کند.
+
+## ۵. حالت‌های خطا و رفتار مورد انتظار سیستم
+
+| حالت خطا | رفتار مورد انتظار |
+|---|---|
+| وارد کردن نام کاربری یا رمز عبور اشتباه | نمایش پیام خطای ورود و باقی ماندن در صفحه ورود |
+| خالی بودن فیلدهای ضروری هنگام ثبت گزارش | جلوگیری از ثبت و مشخص کردن فیلدهای ناقص |
+| بروز خطا هنگام ذخیره گزارش | نمایش پیام عدم موفقیت و امکان تلاش مجدد |
+| تلاش کاربر برای مشاهده گزارش غیرمجاز | جلوگیری از دسترسی و نمایش پیام مناسب |
+| ارجاع گزارش بدون انتخاب تعمیرکار | جلوگیری از ارجاع و درخواست انتخاب تعمیرکار |
+| ثبت نتیجه تعمیر بدون توضیحات ضروری | نمایش خطا و درخواست تکمیل اطلاعات |
+
+## ۶. نکات و تصمیم‌های طراحی
+
+- صفحات بر اساس نقش کاربر طراحی شده‌اند و گزینه‌های قابل مشاهده به سطح دسترسی او وابسته هستند.
+- شناسه گزارش پس از ثبت موفق توسط سیستم اختصاص داده می‌شود.
+- وضعیت گزارش باید در صفحات مختلف به‌صورت هماهنگ نمایش داده شود.
+- اطلاعاتی مانند اولویت، تعمیرکار مسئول و نتیجه تعمیر فقط پس از ثبت توسط کاربران مجاز نمایش داده می‌شوند.
+- طراحی فعلی مفهومی است و جزئیات گرافیکی و فنی در مراحل بعدی تکمیل خواهند شد.
+- در طراحی نهایی باید از نمایش یا ویرایش اطلاعات توسط کاربران فاقد مجوز جلوگیری شود.
+
+## ۷. نکات و کارهای باقی‌مانده
+
+- بازبینی صفحات توسط اعضای تیم
+- تطبیق فیلدهای فرم ثبت خرابی با مستند نیازمندی‌ها و داستان‌های کاربر
+- نهایی‌سازی وضعیت‌های ممکن برای گزارش خرابی
+- بررسی جزئیات سطح دسترسی هر نقش
+- تکمیل طراحی صفحات بر اساس بازخورد تیم و استاد
+
+## ۸. وضعیت سند
+
+نسخه اولیه (Draft) – آماده بازبینی