# PoDrodze — User Stories + mapowanie na persony i epiki w Jira

# Persony

  • P1 Organizator podróży
  • P2 Uczestnik wyjazdu
  • P3 Rodzina planująca wakacje
  • P4 Administrator systemu

# Mapowanie person na user stories

Legenda

  • główna wartość
  • ◻️ opcjonalnie
Persona \ US US-001 US-002 US-003 US-004 US-005 US-006 US-007 US-008 US-009 US-010 US-011
P1 Organizator ◻️ ◻️
P2 Uczestnik
P3 Rodzina ◻️ ◻️
P4 Administrator

# Mapowanie user stories na persony i epiki w Jira

  • US-001 Persony P1 P3 Epik w Jira KAN-102 Trip Management
  • US-002 Persony P1 P2 P3 Epik w Jira KAN-103 Collaboration & Members
  • US-003 Persony P1 P2 P3 Epik w Jira KAN-107 Integracja z Google Places
  • US-004 Persony P2 P1 P3 Epik w Jira KAN-102 Trip Management
  • US-005 Persony P1 P3 Epik w Jira KAN-107 Integracja z Google Places
  • US-006 Persony P2 P3 P1 Epik w Jira KAN-104 Preferencje użytkowników
  • US-007 Persony P1 P2 P3 Epik w Jira KAN-102 Trip Management
  • US-008 Persony P1 P2 P3 Epik w Jira KAN-102 Trip Management
  • US-009 Persony P1 P2 P3 Epik w Jira KAN-105 Autoryzacja i rejestracja
  • US-010 Persony P4 Epik w Jira KAN-106 Administracja i zarządzanie systemem
  • US-011 Persony P4 Epik w Jira KAN-106 Administracja i zarządzanie systemem

# Historyjka US-001 Tworzenie podróży

Persony P1 P3
Epik w Jira KAN-102 Trip Management

# Opis

Użytkownik jako organizator lub planujący сhce stworzyć nową podróż aby rozpocząć wspólne planowanie wyjazdu w jednym miejscu

# Kryteria akceptacji

  • Użytkownik zalogowany może otworzyć formularz tworzenia podróży
  • Formularz wymaga co najmniej nazwy, daty startu, daty końca i lokalizacji
  • Po poprawnym zapisie podróż zostaje utworzona, a użytkownik przechodzi do widoku szczegółów podróży
  • System waliduje daty start_date mniejsze lub równe end_date

# Priorytet i estymacja

Priorytet: Medium


# Historyjka US-002 Zapraszanie uczestników do podróży

Persony P1 P2 P3
Epik w Jira KAN-103 Collaboration & Members

# Opis

Użytkownik jjako organizator lub edytor podróży chce zaprosić znajomych do podróży, aby mogli współtworzyć plan i podejmować decyzje

# Kryteria akceptacji

  • Organizator może wysłać zaproszenie na podany adres e-mail
  • Wysłane zaproszenie ma status pending
  • Zaproszony użytkownik może zaakceptować zaproszenie, a status zmienia się na accepted
  • Zaproszony użytkownik może odrzucić zaproszenie, a status zmienia się na declined
  • Użytkownik bez akceptacji zaproszenia nie ma dostępu do danych podróży

# Priorytet i estymacja

Priorytet High


# Historyjka US-003 Dodawanie miejsc z kategorii Google Places

Persony P1 P2 P3
Epik w Jira KAN-107 Integracja z Google Places

# Opis

Użytkownik-uczestnik podróży chce dodawać miejsca z wybranych kategorii, aby budować wspólną listę punktów do odwiedzenia

# Kryteria akceptacji

  • Użytkownik należący do podróży może wyszukać miejsce przez Google Places i dodać je do podróży
  • Dodane miejsce pojawia się na liście miejsc podróży z podstawowymi danymi i lokalizacją
  • Miejsce ma przypisaną kategorię
  • System nie tworzy duplikatów tego samego miejsca w obrębie jednej podróży
  • W razie błędu integracji użytkownik widzi komunikat i może spróbować ponownie

# Priorytet i estymacja

Priorytet High


# Historyjka US-004 Głosowanie na miejsca

Persony P2 P1 P3
Epik w Jira KAN-102 Trip Management

# Opis

Użytkownik-uczestnik podróży chce głosować na miejsca, aby grupa mogła ustalić priorytety i wybrać najlepsze propozycje

# Kryteria akceptacji

  • Użytkownik należący do podróży może oddać głos na miejsce z poziomu listy miejsc
  • Po oddaniu głosu licznik głosów aktualizuje się w interfejsie
  • System uniemożliwia podwójne naliczanie głosu tego samego użytkownika na tym samym miejscu
  • Użytkownik może cofnąć głos, działanie typu przełącznik: "oddaj" lub "cofnij", a licznik aktualizuje się poprawnie
  • Użytkownik spoza podróży nie może głosować

# Priorytet i estymacja

Priorytet Medium


# Historyjka US-005 Oznaczanie miejsca jako stałe

Persony P1 P3
Epik w Jira KAN-107 Integracja z Google Places

# Opis

Użytkownik jako organizator lub uczestnik z uprawnieniami chce oznaczyć miejsce jako stałe, aby wszyscy wiedzieli że jest obowiązkowe na przykład hotel/lotnisko

# Kryteria akceptacji

  • Uprawniony użytkownik może oznaczyć miejsce jako stałe
  • Miejsce stałe jest wyraźnie oznaczone na liście miejsc
  • Miejsce stałe jest widoczne lub oznaczone na mapie
  • Podczas generowania planu podróży miejsca stałe są uwzględniane jako obowiązkowe
  • Użytkownik bez uprawnień nie może oznaczać miejsc jako stałe

# Priorytet i estymacja

Priorytet Medium


# Historyjka US-006 Preferencje kategorii użytkownika

Persony P2 P3 P1
Epik w Jira KAN-104 Preferencje użytkowników

# Opis

Użytkownik-uczestnik podróży chce ustawić preferencje kategorii wagi, aby rekomendacje i plan były dopasowane do zainteresowań

# Kryteria akceptacji

  • Użytkownik może ustawić wagi dla kategorii i zapisać preferencje
  • Preferencje są zachowane i widoczne
  • System ma wartości domyślne jeśli użytkownik nie ustawi preferencji
  • System waliduje zakres wag
  • Tylko członkowie podróży mogą ustawiać preferencje dla tej podróży

# Priorytet i estymacja

Priorytet Medium


# Historyjka US-007 Generowanie planu podróży na dni

Persony P1 P2 P3
Epik w Jira KAN-102 Trip Management

# Opis

Użytkownik-uczestnik podróży chce wygenerować plan podróży na dni, żeby otrzymać uporządkowany plan do realizacji podczas wyjazdu

# Kryteria akceptacji

  • Użytkownik może uruchomić generowanie planu z poziomu widoku podróży
  • Plan jest podzielony na dni zgodnie z datami podróży
  • Plan uwzględnia miejsca stałe jako obowiązkowe punkty
  • Jeśli podróż nie ma miejsc system informuje użytkownika o konieczności ich dodania
  • W przypadku błędu generowania użytkownik dostaje komunikat

# Priorytet i estymacja

Priorytet High


# Historyjka US-008 Rekomendacje AI miejsc

Persony P1 P2 P3
Epik w Jira KAN-102 Trip Management

# Opis

Użytkownik-uczestnik podróży chce otrzymać rekomendacje AI, aby łatwiej wybrać miejsca pasujące do preferencji go i grupy

# Kryteria akceptacji

  • Użytkownik może uruchomić rekomendacje AI z poziomu podróży
  • Rekomendacje są powiązane z preferencjami i lub głosami
  • Każda rekomendacja zawiera krótkie uzasadnienie
  • Wynik rekomendacji jest prezentowany

# Priorytet i estymacja

Priorytet Medium


# Historyjka US-009 Logowanie przez Facebook/Google

Persony P1 P2 P3
Epik w Jira KAN-105 Autoryzacja i rejestracja

# Opis

Użytkownik chce zalogować się przez Facebook dla szybkiego uzyskania dostępu do aplikacji

# Kryteria akceptacji

  • Użytkownik może rozpocząć proces logowania przez Facebook/Google OAuth
  • Po poprawnym logowaniu użytkownik wraca do aplikacji zalogowany
  • Po odmowie lub przerwaniu procesu użytkownik widzi komunikat o niepowodzeniu
  • Użytkownik po zalogowaniu ma dostęp do funkcji wymagających autoryzacji

# Priorytet i estymacja

Priorytet High


# Historyjka US-010 Admin Zarządzanie użytkownikami

Persony P4
Epik w Jira KAN-106 Administracja i zarządzanie systemem

# Opis

Administrator chce zarządzać użytkownikami

# Kryteria akceptacji

  • Administrator widzi listę użytkowników w panelu administratora
  • Administrator może otworzyć szczegóły użytkownika
  • Administrator może wykonać akcje administracyjne na koncie użytkownika
  • Dostęp do panelu jest zablokowany dla zwykłych użytkowników
  • Akcje administracyjne są potwierdzane i skutkują zmianą w systemie

# Dodatkowe informacje

  • Przykładowe akcje: blokada użytkownika, usunięcie użytkownika

# Priorytet i estymacja

Priorytet High


# Historyjka US-011 Podgląd logów aplikacji

Persony P4
Epik w Jira KAN-106 Administracja i zarządzanie systemem

# Opis

Administrator chce widzieć logi aplikacji

# Kryteria akceptacji

  • Administrator może otworzyć widok logów w panelu administratora
  • Logi są wyświetlane jako lista wpisów z czasem, poziomem i wiadomością
  • Widok logów nie ujawnia danych wrażliwych
  • Gdy logi są puste lub niedostępne użytkownik widzi komunikat bez błędu 500
  • Dostęp do logów jest ograniczony wyłącznie do administratora

# Priorytet i estymacja

# Priorytet High