paya-university-fault-system/docs/analysis/user-story.md

# داستان‌های کاربر (User Stories) – سامانه مدیریت و گزارش خرابی دانشگاهی

**تهیه‌کننده:** امیرحسن عارف اصل  
**بازبین:** ارشیا همتی‌زاده  
**آخرین به‌روزرسانی:** ۱۴۰۴/۰۸/۰۴

---

## مقدمه

در این سند، نیازمندی‌های اصلی سامانه به صورت **داستان کاربر (User Story)** نوشته شده‌اند.  
هر داستان کاربر از دیدگاه یک نقش مشخص بیان می‌شود و هدف آن را نیز مشخص می‌کند.

قالب استاندارد:

> به عنوان یک **<نقش>**  
> می‌خواهم **<هدف>**  
> تا بتوانم **<مزیت / نتیجه>**

---

## داستان‌های کاربر مرتبط با گزارش‌دهنده (دانشجو / استاد)

### US-01
به عنوان یک **دانشجو**  
می‌خواهم **خرابی مشاهده‌شده را به همراه مکان و توضیحات ثبت کنم**  
تا بتوانم **مشکل را سریع به بخش تأسیسات اطلاع دهم و پیگیری کنم**.

### US-02
به عنوان یک **استاد**  
می‌خواهم **خرابی کلاس یا آزمایشگاه را ثبت کنم**  
تا بتوانم **بدون اتلاف وقت، مشکل را به مسئولان مربوطه اعلام کنم**.

### US-03
به عنوان یک **دانشجو یا استاد**  
می‌خواهم **وضعیت گزارش‌هایی که خودم ثبت کرده‌ام را مشاهده کنم**  
تا بتوانم **از پیشرفت رسیدگی به گزارشم مطلع شوم**.

### US-04
به عنوان یک **دانشجو یا استاد**  
می‌خواهم **تصویر یا توضیح بیشتری به گزارش قبلی اضافه کنم**  
تا بتوانم **اطلاعات کامل‌تری در اختیار تعمیرکار قرار دهم**.

### US-05
به عنوان یک **دانشجو یا استاد**  
می‌خواهم **پس از اعلام رفع خرابی، آن را تأیید یا رد کنم**  
تا بتوانم **از بسته شدن صحیح گزارش مطمئن شوم**.

---

## داستان‌های کاربر مرتبط با کارمند تأسیسات

### US-06
به عنوان یک **کارمند تأسیسات**  
می‌خواهم **لیست تمام گزارش‌های باز را مشاهده و فیلتر کنم**  
تا بتوانم **گزارش‌های مهم و فوری را سریع‌تر پیدا کنم**.

### US-07
به عنوان یک **کارمند تأسیسات**  
می‌خواهم **اولویت هر گزارش را تعیین کنم**  
تا بتوانم **تعمیرات را بر اساس اهمیت و فوریت مدیریت کنم**.

### US-08
به عنوان یک **کارمند تأسیسات**  
می‌خواهم **یک گزارش را به تعمیرکار مناسب تخصیص دهم**  
تا بتوانم **کار را به فرد درست ارجاع دهم و پیگیری کنم**.

### US-09
به عنوان یک **کارمند تأسیسات**  
می‌خواهم **وضعیت گزارش را تغییر دهم**  
تا بتوانم **وضعیت واقعی رسیدگی به هر گزارش را در سیستم منعکس کنم**.

### US-10
به عنوان یک **کارمند تأسیسات**  
می‌خواهم **تاریخچه کامل اقدامات انجام‌شده روی یک گزارش را ببینم**  
تا بتوانم **روند رسیدگی را بررسی و در صورت نیاز پیگیری کنم**.

---

## داستان‌های کاربر مرتبط با تعمیرکار

### US-11
به عنوان یک **تعمیرکار**  
می‌خواهم **لیست کارهای تخصیص‌یافته به خودم را ببینم**  
تا بتوانم **بدانم چه کارهایی در انتظار انجام است**.

### US-12
به عنوان یک **تعمیرکار**  
می‌خواهم **شروع کار روی یک گزارش را اعلام کنم**  
تا بتوانم **وضعیت گزارش را به «در حال تعمیر» تغییر دهم**.

### US-13
به عنوان یک **تعمیرکار**  
می‌خواهم **نتیجه تعمیر را همراه با توضیحات ثبت کنم**  
تا بتوانم **گزارش را به مرحله بعدی (تأیید یا پیگیری) برسانم**.

### US-14
به عنوان یک **تعمیرکار**  
می‌خواهم **در صورت نیاز، اطلاعات بیشتری از گزارش‌دهنده درخواست کنم**  
تا بتوانم **تعمیر را با اطلاعات کامل‌تری انجام دهم**.

---

## داستان‌های کاربر مشترک / سیستمی

### US-15
به عنوان یک **کاربر سیستم**  
می‌خواهم **با نام کاربری و رمز عبور وارد سامانه شوم**  
تا بتوانم **به امکانات مربوط به نقش خودم دسترسی داشته باشم**.

### US-16
به عنوان یک **کاربر سیستم**  
می‌خواهم **هنگام تغییر وضعیت گزارش مرتبط با خودم، اعلان دریافت کنم**  
تا بتوانم **از آخرین وضعیت مطلع شوم**.

### US-17
به عنوان یک **کارمند تأسیسات یا مدیر**  
می‌خواهم **داشبورد خلاصه‌ای از تعداد گزارش‌های باز و فوری ببینم**  
تا بتوانم **وضعیت کلی خرابی‌ها را سریع ارزیابی کنم**.

---

## نکات و کارهای باقی‌مانده

- این داستان‌ها نسخه اولیه هستند و ممکن است در بازبینی تغییر کنند یا داستان‌های جدید اضافه شود.
- جزئیات پذیرش (Acceptance Criteria) برای داستان‌های مهم‌تر در مراحل بعدی نوشته خواهد شد.
- ابهام دامنه (آیا خوابگاه‌ها و فضاهای اداری هم شامل می‌شوند؟) هنوز وجود دارد و روی برخی داستان‌ها تأثیر می‌گذارد.

---

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