User Stories

The main actors are the suit users, the administrators and the researchers so we divided the user stories by the actors and each user story will have it's acceptance criteria.

Suit Users

-> US-1: As a suit user, I want to receive alerts about my posture so that I can prevent injuries in the future.

Acceptance Criteria:

1. User must be wearing a suit and have it properly calibrated
2. User must be logged in to the app
3. User must connect the suit to his account
4. The app should analyse the data collected from the suit
5. The app should alert the user if the posture is not correct
6. System must analyze movement data in real-time
7. The app should alert the user if the posture is not correct. It must be triggered when:
   a. Incorrect posture maintained for >30 seconds
   b. Joint angles exceed safe limits
   c. Risk movement pattern is detected
   
8. Multiple alert types available:
   a. In-app notification
   b. Sound alert (optional)
   

-> US-2: As a suit user, I want to check my stats on the app so that I can see my improvements over time.

Acceptance Criteria:

1. User must be logged in to the app
2. The app must have a tab where the records of the user are kept - the app must keep the records per user
3. The records tab must have graphics that show progress over time
4. Charts must show:
   a. Posture trend (weekly/monthly)
   b. Time in risk postures per day
   c. Percentage improvement over time
   d. Period filters: 7 days, 30 days, 3 months
   e. Option to export data as PDF for sharing with healthcare professionals
   

-> US-3: As a suit user, I want to check real time metrics so that I can see my results while I’m working.

Acceptance Criteria:

1. User must be logged in the app
2. The app must have a tab with the records (and dashboards, in real time)
3. Real-time metrics:
   a. Heart rate
   b. Current posture angles.
   c. Body temperature
   d. Suit battery status
   
4. Visual status indicators:
   a. Green (normal), Yellow (warning), Red (risk)
   
5. Automatic updates every 2 seconds

-> US-4: As a suit user I want to customize my alerts so that I can adapt the system to my specific needs.

Acceptance Criteria:

1. Configure alert sensitivity (low/medium/high)
2. Choose preferred notification type (vibration/sound/visual)
3. Set quiet hours (e.g., during meetings)
4. Customize thresholds for different posture types

-> US-5: As a suit user I want to set personalized posture improvement goals so that I can have clear targets to work towards and measure my progress.

Acceptance Criteria:

1. Users can create daily/weekly goals with specific targets:
   a. Maximum time allowed in risk postures (e.g. "less than 30 minutes per day")
   b. Target for "good posture" minutes (e.g. "at least 4 hours of good posture daily")
   c. Reduction goals for specific risk patterns (e.g. "reduce forward neck bending by 20%")
   
2. Goal customization options:
   a. Adjustable difficulty levels (beginner/intermediate/advanced)
   b. Time-bound goals (daily, weekly, or custom periods)
   c. Specific body part focus (neck, back, shoulders)
   
3. Goal validation:
   a. Warning for overly ambitious targets
   b. Success probability indicator

-> US-6: As a suit user I want to visually track my goal progress in real-time so that I can stay motivated and see how close I am to achieving my targets.

Acceptance Criteria:

1. Real-time progress indicators:
   a. Progress bars showing daily/weekly goal completion
   b. Color-coded indicators (red/yellow/green) for each active goal
   c. Countdown timers for time-bound goals
   
2. Streak tracking:
   a. Consecutive days meeting daily goals
   b. Longest streak history
   
3. Detailed progress analytics:
   a. Comparison between set goals and actual performance
   
4. Progress notifications:
   a. "Almost there" alerts when close to achieving goals
   b. Weekly progress summary reports

-> US-7: As a suit user I want to earn rewards and recognition for achieving my posture goals so that I stay motivated and engaged with my posture improvement journey.

Acceptance Criteria:

1. Badge and achievement system:
   a. "Posture Pioneer" for first week of consistent good posture
   b. "Risk Reducer" for significant reduction in risk postures
   c. "Consistency Champion" for 30-day streaks
   d. Profession-specific achievements
   
2. Points and leveling system:
   a. Points awarded for goal completion and streak maintenance
   b. Level progression with visual status indicators
   
3. Visual celebrations:
   a. Animated confetti and success messages for goal completion
   
4. Reward tiers:
   a. Bronze/Silver/Gold/Platinum levels based on consistency
   b. Special rewards for maintaining goals over 3, 6, 12 months
   c. "Posture Master" status for exceptional long-term improvement

-> US-8: As a suit user I want to easily calibrate my suit so that I can ensure accurate measurements and reliable posture detection.

Acceptance Criteria:

1. Simple calibration initiation:
   a. One-touch calibration start from mobile app
   b. Clear visual instructions for calibration poses
   c. Progress indicator during calibration process
   
2. Calibration feedback and validation:
   a. Real-time sensor data quality indicators
   b. Success confirmation
   
3. Calibration management:
   a. Calibration history and timestamps
   b. Automatic calibration reminders (suggested every 2 weeks)
   c. Factory reset option for calibration data
   

-> US-9: As a suit user I want to monitor battery status so that I can plan my usage and avoid interruptions during important activities.

Acceptance Criteria:

1. Comprehensive battery monitoring:
   a. Real-time battery percentage display
   
2. Smart battery notifications:
   a. Low battery warnings (20%, 10%, 5%)

Administration

-> US-10: As an administrator I want to have access to all the information so that I can help and monitor the students' work.

Acceptance Criteria:

1. Full access to GitHub organization (all repositories)
2. Access to all project documentation
3. Administrator permissions in all systems
4. Activity logs for all users
5. Ability to reset passwords and manage accounts

-> US-11: As an administrator I want to manage user accounts so that I can control access and provide support.

Acceptance Criteria:

1. Create, edit, and deactivate user accounts
2. Assign different profiles (user/researcher/admin)
3. Password reset when needed
4. View usage statistics per user

Research

-> US-12: As a researcher I want to analyze the captured data so that I can identify postural deviations and abnormal patterns.

Acceptance Criteria:

1. Read-only access to complete database
2. Advanced query and filtering tools
3. Data export in formats:
   a. CSV for statistical analysis
   b. JSON for additional processing
   
4. Ability to correlate multiple variables:
   a. Posture vs. time of day
   b. Fatigue vs. postural quality
   c. Temperature vs. physical activity

-> US-13: As a researcher I want to compare data between different user groups so that I can identify demographic and occupational patterns.

Acceptance Criteria:

1. Group users by:
   a. Profession (factory/construction/office etc)
   b. Age and gender
   c. Injury history
   
2. Comparative statistical analysis between groups
3. Visualization of significant differences
4. Automatic comparison reports