# REQUEST: Ticket T00831 — Feedback and Survey tab changes

- **Status**: Working Draft (awaiting confirmation)
- **Owner**: 6E-Ops
- **Requested by**: RAPTOR_IndiGo
- **Source note**: “RAPTOR_IndiGo posted 08/05/25 [MM/DD/YY] 16:50:54”
- **Last updated**: 2025-09-22

## 1) Summary

* Make the Feedback tab universally available to every trainee after each SIM/Line event in iGrade, independent of overall grade.
* When a SIM/Line event completes and syncs to the iPad app, the app should prompt the trainee to complete feedback.
* The survey content is defined by the business (via the Front-end Survey tab configuration) and is bifurcated into different streams with distinct export rules:

> 1) **Device Feedbacks** — Identified (open transparency). Keep per-user copies and enable bulk per-submission exports.
> 2) **Trainer Behavioural-related Feedback** — Anonymous only [But Audits maintained in the B/End Tables for internal 6E-BI Reports]. At F/end Store no trainee user details and expose only aggregated results (averages, counts) in exports/visibility as in: [[Currentely 6E - Followed Structure]](https://hackmd.io/@xtPTlGxdRV2FA7rSmohSJA/rkEN6dAsel?stext=6381%3A2325%3A0%3A1758704815%3AgzC5ue)
> 3) **Generic Feedback** — Identified (open transparency). Always available for trainees to report open concerns; per-user copies and exports for closure and audit.

* Also address the previously noted proper ordering of the different Grading Scale UI issues.

## 2. Feedback Categories

Feedback may be bifurcated into three distinct categories:

| Category | Anonymity Policy | Data Storage | Key Purpose |
| ------------------------- | ------------------------- | ------------------------------------------ | ---------------------------------------------- |
| **A. Device-A/c Feedback** | **Identified** | Per-submission with trainee & session ID | Report on ALL device performance & issues as per event completes. |
| **B. Trainer Behavioral** | **Anonymous [unless defined]** | **NO** user identifiers F/end (Except for Audits maintained in the B/End Tables for internal 6E-BI Reports) | Assess trainer conduct as per 6E defined behavioral questions and grading scales defined. |
| **C. Generic Feedback** | **Identified** | Per-submission with trainee ID | Raise open concerns for follow-up and audit. |

## 3) Scope

In scope:
- (iGrade)iPad: Universal prompt post SIM/Line completion; Feedback tab visibility.
- Exports: category-specific xls exports (aggregated for trainer behavioral; per-submission for SIM Device and Generic).
- Role-based visibility and privacy controls.
- Minor UI ordering fix [Grading Scale] in the Feedback tab.

## 4) User Stories

- As a trainee, after a SIM/Line event completes in iGrade, Prompted on iPad [iGrade] to submit feedback, regardless of the **overall grade**.
- As a trainee, can submit SIM Device feedback where user identity is recorded and visible to authorized roles from ITMS F/end.
- As a trainee, can submit Trainer Behavioral feedback anonymously; no one can see the identity, and outputs are aggregated (averages, counts).
- As a trainee, can submit Generic feedbacks at any time to raise concerns; identity is recorded so the team can follow up and close the loop.
- As an admin, can export SIM Device and Generic feedback per submission, including who submitted it, for investigation and closure.
- As an admin, can export aggregated trainer behavioral feedbacks per trainer and parameter, with average rating and number of submissions, without any trainee details.

## 5) High-Level Flow

1) iGrade marks a SIM/Line event “Completed”.
2) iGrade app receives completion event (online) or on next sync (offline).
3) App prompts trainee to open Feedback tab.
4) Feedback tab shows different sections:
- SIM Device Feedback (identified)
- Trainer Behavioral Feedback (anonymous-only)
- Generic Feedback (identified; always open)
5) Trainee completes one or more sections; submissions sync immediately.
6) Admins access reports/exports per category with appropriate visibility.

## 6) Functional Requirements

* ### 6.1) Universal Prompting
- Trigger: Every SIM/Line event completion, irrespective of overall grade.
- Re-prompt: Configurable if deferred (e.g., on next app launch or daily until submitted or expired).
- Hyper-linked from prompt directly to the relevant session’s Feedback tab.

* ### 6.2) Survey Templates
- Business-configured templates per category (SIM Device, Trainer Behavioral, Generic).
- Supported questions: Likert/numeric (e.g., 1–10), multiple choice, free text.
- Templates may vary by Fleet and Training Category if configured.

* ### 6.3) Submission UX
- Save draft and resume.
- Validation for *required (mandatory) fields.
- Offline capable with queued sync and retry.

* ### 6.4) Visibility & Permissions
- Admins: Full access to SIM Device and Generic per-user submissions; access to aggregated trainer behavioral exports only.
- Trainer/Instructor: May receive aggregated behavioral summaries for themselves (no trainee details).

* ### 6.5) Reporting & Exports
- Filters: date range, trainer, fleet, training category/parameter, device.
- Exports:
- Trainer Behavioral: Aggregated per trainer per parameter with average rating and submission count;
- SIM Device: Per-submission export with trainee identifiers and session details.
- Generic: Per-submission export with trainee identifiers and session context.

* ### 6.6) **Feedback Status**:
* Field (e.g., Not Shared/Shared/Not yet Started) managed by admins to track; included in exports.

## 7) UI/UX Details

- Feedback Tab (post SIM/Line)
- Header: Session summary (type, date, trainer, fleet, training category).
- Sections (proposed order):
1. SIM Device Feedback (identified)
2. Trainer Behavioral Feedback (anonymous-only)
3. Generic Feedback (identified; always open)
- Actions: Submit, Save draft.

- Offline and Errors
- Offline banner and “Will sync when online.”

## 8) Export Specifications

- Trainer Behavioral (Aggregated)
- Columns (proposed):
- Trainer Name
- Trainer Email ID
- Parameter Name
- Average Rating Value
- No.of people submitted
- Feedback Status
- Fleet
- TrainingCategory

*Ex [Currentely 6E - Followed Structure]:*

| Trainer Name | Trainer Email ID | Parameter Name                                                                 | Average Rating Value | No. of people submitted | Feedback Status | Fleet | TrainingCategory |
|--------------|------------------|--------------------------------------------------------------------------------|----------------------|-------------------------|-----------------|-------|------------------|
| AAKASH ARORA |                  | Trainer’s knowledge of course content?                                         | 9.5                  | 17                      | Not Shared      | Null  | Null             |
|              |                  | Trainer’s ability to adapt the session to your requirement?                    | 9.2                  |                         |                 |       |                  |
|              |                  | Trainer’s conduct and behavior towards you?                                    | 9.5                  |                         |                 |       |                  |
|              |                  | Trainer’s conduct and behavior towards others?                                 | 9.5                  |                         |                 |       |                  |
|              |                  | Trainer’s receptiveness to questions and challenges posed by you?              | 9.3                  |                         |                 |       |                  |
|              |                  | Trainer’s ability to keep you motivated and interested during training session?| 8.9                  |                         |                 |       |                  |
|              |                  | Trainer’s compliance with course outline?                                      | 9.1                  |                         |                 |       |                  |
|              |                  | Trainer’s ability to ensure that you were ready & able to receive information? | 8.9                  |                         |                 |       |                  |
|              |                  | Please grade the overall training experience?                                  | 9.2                  |                         |                 |       |                  |

- SIM Device (Per-submission)
- Columns (proposed):
- Submission
- Session
- Trainee Name
- Trainee IGA
- Fleet
- Device Id [Reg iD/Number]
- Parameter Name
- Answer (rating/value/text)
- Submitted At
- Feedback Status

- Generic (Per-submission)
- Columns (proposed):
- Submission ID
- Session ID (optional if out-of-session)
- Trainee Name
- Trainee IGA
- Fleet
- Topic/Category (if defined)
- Comment/Details
- Submitted At
- Feedback Status

## 9) Assumptions

- iGrade events are synced in real-time as per the Daily APIs to the mobile app.
- Survey templates are versioned and mapped to categories/fleets/training categories.

## 10) Change Log

- 2025-09-22:
- Updated to reflect universal Feedback tab after every SIM/Line event (independent of overall outcome).
- **SIM Device**: Identified by SIM Reg ID (per-user) and the Training Schedule Details.
- **Trainer Behavioural**: Anonymous-only(unless defined) (aggregated only)[[Currentely 6E - Followed Structure]](https://hackmd.io/@xtPTlGxdRV2FA7rSmohSJA/rkEN6dAsel?stext=6381%3A2325%3A0%3A1758704815%3AgzC5ue).
- **Generic**: Identified (per-user), always open.
- Introduced feedback categories with distinct identity/privacy policies.
- Added aggregated trainer behavioral export spec and per-submission SIM Device/Generic export specs.