amir
407596264f
Align docs/analysis files on one structure: metadata header, unnumbered "مقدمه", numbered sections, and a final "نکات و پرسش‌های باز" section. - user-story.md: add "نیازمندی‌های مرتبط" (FR refs) to each US, number the sections, and update the last-updated date - requirements-specification.md: define "گزارش‌دهنده" and align the closing section name - activity.md: add metadata header and مقدمه, drop English actor labels, give each diagram an AD-NN id, and add a status line - CONTRIBUTING.md: record the analysis docs standard as section ۷ - features/: Gherkin scenarios for US-01, US-05 and US-15
7.5 KiB
داستان‌های کاربر (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 علامت‌گذاری شده‌اند.
- ابهام دامنه (آیا خوابگاه‌ها و فضاهای اداری هم شامل می‌شوند؟) هنوز وجود دارد و روی برخی داستان‌ها تأثیر می‌گذارد.
- پرسش‌های باز دیگر (اولویت‌ها، وضعیت‌ها، اعلان‌ها و ...) در بخش «نکات و پرسش‌های باز» نمودارهای فعالیت فهرست شده‌اند.
وضعیت سند: نسخه اولیه (Draft) – آماده بازبینی