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

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

---

## مقدمه

در این سند، نیازمندی‌های اصلی سامانه به صورت **داستان کاربر (User Story)** نوشته شده‌اند.  
هر داستان کاربر از دیدگاه یک نقش مشخص بیان می‌شود و هدف آن را نیز مشخص می‌کند.  
معیارهای پذیرش (Acceptance Criteria) هر داستان در Issue متناظر آن در GitHub ثبت شده‌اند.

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

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

---

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

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

**نیازمندی‌های مرتبط:** FR-03، FR-05

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

**نیازمندی‌های مرتبط:** FR-03

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

**نیازمندی‌های مرتبط:** FR-05، FR-16

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

**نیازمندی‌های مرتبط:** FR-04

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

**نیازمندی‌های مرتبط:** FR-14

---

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

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

**نیازمندی‌های مرتبط:** FR-06، FR-08

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

**نیازمندی‌های مرتبط:** FR-07

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

**نیازمندی‌های مرتبط:** FR-09

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

**نیازمندی‌های مرتبط:** FR-11

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

**نیازمندی‌های مرتبط:** FR-16

---

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

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

**نیازمندی‌های مرتبط:** FR-10

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

**نیازمندی‌های مرتبط:** FR-11

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

**نیازمندی‌های مرتبط:** FR-12

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

**نیازمندی‌های مرتبط:** FR-13

---

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

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

**نیازمندی‌های مرتبط:** FR-01، FR-02

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

**نیازمندی‌های مرتبط:** FR-15

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

**نیازمندی‌های مرتبط:** FR-17

---

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

- این داستان‌ها نسخه اولیه هستند و ممکن است در بازبینی تغییر کنند یا داستان‌های جدید اضافه شود.
- معیارهای پذیرش هر داستان در Issue متناظر آن در GitHub ثبت شده‌اند. در مواردی که نیازمندی‌ها هنوز مشخص نیستند، فرض‌های موقت در همان Issue علامت‌گذاری شده‌اند.
- ابهام دامنه (آیا خوابگاه‌ها و فضاهای اداری هم شامل می‌شوند؟) هنوز وجود دارد و روی برخی داستان‌ها تأثیر می‌گذارد.
- پرسش‌های باز دیگر (اولویت‌ها، وضعیت‌ها، اعلان‌ها و ...) در بخش «نکات و پرسش‌های باز» [نمودارهای فعالیت](activity.md) فهرست شده‌اند.

---

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