Knowledge Base

User Tools

Site Tools

Trace: • advanced_search • results_interaction • introduction • flows_management • introduction • roles_and_authentication
damsym:feedback_and_ratings

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
damsym:feedback_and_ratings [2026/01/15 16:26] – created finconsdamsym:feedback_and_ratings [2026/02/12 12:37] (current) – fincons
Line 3: Line 3:
 ===== General Description ===== ===== General Description =====
  
-The Feedback and Review system represents an essential component within DaMSym, designed to ensure qualitative control over the results returned by the semantic search engine. +The Feedback system represents an essential tool within DaMSym, designed to ensure qualitative control of the results returned by the semantic search engine. 
-This functionality allows users with the Reviewer role to express an evaluation of the relevance and semantic accuracy of the results, thus contributing to the continuous improvement of the corpus and to the scientific validation of the contents. + 
-The review mechanism is based on a simple but structured model: for each displayed result, the Reviewer can provide either positive or negative feedback, optionally accompanied by an explanatory note. +This functionality allows users with the Reviewer role to express a judgment on the relevance and semantic accuracy of the results, thereby contributing to the continuous improvement of the corpus and to the scientific validation of the content. 
-All feedback is stored in the system and can be consulted by the WP Lead, who is also able to export it in tabular format for analysis and reporting purposes.+ 
 +The rating mechanism is based on a simple yet structured model: for each displayed result, the Reviewer may leave a positive or negative feedback, accompanied by an optional explanatory note. 
 + 
 +All feedback entries are stored within the system and can be consulted by the WP Lead, who has the possibility to export them in tabular format for analysis and reporting purposes.
  
 ---- ----
Line 13: Line 16:
  
 The feedback system is available exclusively to authenticated users with the Reviewer role. The feedback system is available exclusively to authenticated users with the Reviewer role.
-Other roles interact differently with the system, as described below: 
  
-^ Role ^ Interaction with the feedback system ^+Other roles interact with the feedback system in a differentiated manner: 
 + 
 +^ Role ^ Interaction with the Feedback System ^
 | **Guest** | No access or interaction. | | **Guest** | No access or interaction. |
-| **Researcher** | Cannot submit evaluations; can only consult search results. | +| **Researcher** | No possibility to evaluate results; can only consult search results. | 
-| **Reviewer** | Can submit positive or negative evaluations and add descriptive notes. | +| **Reviewer** | Can leave positive or negative evaluations and add descriptive notes. | 
-| **WP Lead** | Cannot submit evaluations, but can view all feedback and export it from the Dashboard. |+| **WP Lead** | Cannot leave evaluations but can view all feedback and export them from the Dashboard. |
  
 ---- ----
  
-===== Interface and Workflow =====+===== Interface and Operation =====
  
 For each result displayed on the search results page, Reviewers see two dedicated icons: For each result displayed on the search results page, Reviewers see two dedicated icons:
Line 30: Line 34:
   * 👎 (Thumbs down) → negative feedback   * 👎 (Thumbs down) → negative feedback
  
-By clicking on one of these icons, a feedback modal opens, allowing the Reviewer to:+By clicking on one of these icons, a rating modal window opens, allowing the user to:
  
-  * confirm the selected feedback type; +  * confirm the selected type of feedback; 
-  * optionally add a textual note to justify the evaluation or describe observations; +  * add, if desired, a textual note to justify the evaluation or describe observations; 
-  * submit the evaluation definitively.+  * definitively submit the evaluation.
  
 After submission, the feedback is recorded in the system with the following metadata: After submission, the feedback is recorded in the system with the following metadata:
  
-  * ID of the evaluated result and associated resource; +  * ID of the evaluated result and resource; 
-  * type of evaluation (positive / negative); +  * type of evaluation (positive/negative); 
-  * feedback author (authenticated Reviewer);+  * author of the feedback (authenticated Reviewer);
   * optional descriptive note;   * optional descriptive note;
-  * submission date and time.+  * date and time of submission.
  
-The system does not allow feedback to be modified after submission, in order to ensure data integrity and traceability of the review process. (Figures 6–7) +The system does not allow modification of feedback after submission, in order to guarantee the integrity and traceability of review data.
- +
-Figure 6, Feedback +
- +
-Figure 7, Feedback details+
  
 +{{damsym:damsym_feedback.png?300|Feedback}}
 +{{damsym:damsym_feedback_details.png?700|Feedback details}}
 ---- ----
  
 ===== Feedback Visualization (WP Lead) ===== ===== Feedback Visualization (WP Lead) =====
  
-Users with the WP Lead role do not see the feedback buttons. +Users with the WP Lead role do not see the feedback buttons. Instead, they see a clickable entry labeled “See Ratings” under each result. 
-Instead, they see a clickable item labeled **“See Ratings”** displayed under each result. (Figures 8–11)+
 By selecting this option, a summary window opens containing: By selecting this option, a summary window opens containing:
  
   * the complete list of feedback received for the selected result;   * the complete list of feedback received for the selected result;
-  * notes entered by Reviewers;+  * the notes provided by Reviewers;
   * the date and author of each evaluation.   * the date and author of each evaluation.
  
-In addition, the WP Lead can access the Dashboard, where a dedicated panel allows:+In addition, the WP Lead may access the Dashboard, where a dedicated panel allows the user to:
  
-  * visualization of aggregated feedback by language, author, or date; +  * view aggregated feedback by language, author, or date; 
-  * export of data in CSV or Excel format for further analysis or archiving. +  * export the data in CSV or Excel format for subsequent analysis or archival purposes.
- +
-Figure 8, Export Ratings+
  
 +{{damsym:damsym_export_ratings.png?700|Export ratings}}
 ---- ----
  
 ===== Interaction Between Feedback and Corrections ===== ===== Interaction Between Feedback and Corrections =====
  
-In addition to the evaluation system based on positive/negative ratings, both Reviewers and Researchers can contribute to content quality by proposing direct text corrections or metadata modifications. +In addition to the like/dislike rating system, users with the roles of Reviewer, Researcher, and WP Lead may contribute to improving text quality by proposing textual corrections or metadata modifications.
-In this case:+
  
-  * the Reviewer opens the **More Details** view of a result; +In this context, the interaction flow provides that:
-  * proposes a modification using **Edit Text** or **Edit Metadata**; +
-  * the WP Lead receives the proposal in the Dashboard and can approve or reject it.+
  
-Approved corrections are integrated into the corpus and become part of the definitive text, progressively improving the reliability of the semantic engine.+  * the Reviewer and/or the Researcher access the More Details view of the selected result; 
 +  * for the Edit Text functionality, the user selects a contextualized portion of text, initially highlighted by the system; the selection may be manually extended. Through the contextual icon displayed, the user may proceed with the proposal of a text modification; 
 +  * similarly, it is possible to propose modifications to metadata through the Edit Metadata function, or to add new metadata through Add Metadata, using the dedicated available buttons; 
 +  * all modification proposals are sent to the Corrections section of the Dashboard, where the WP Lead receives the requests and may approve or reject them. 
 + 
 +Corrections approved by the WP Lead are then applied to the corpus, becoming an integral part of the definitive text and resulting directly effective and visible within the platform, thereby contributing to the progressive improvement of the reliability of the semantic engine.
  
 ---- ----
Line 87: Line 90:
  
 The export functionality, accessible exclusively to the WP Lead, allows the generation of a structured file containing all ratings and related notes provided by Reviewers. The export functionality, accessible exclusively to the WP Lead, allows the generation of a structured file containing all ratings and related notes provided by Reviewers.
 +
 The exported file includes the following fields: The exported file includes the following fields:
  
 ^ Field ^ Description ^ ^ Field ^ Description ^
 | **Resource ID** | Unique identifier of the evaluated text or document | | **Resource ID** | Unique identifier of the evaluated text or document |
-| **Language** | Linguistic domain of the resource (Arabic, Slavic, Greek, etc.) | +| **Language** | Linguistic domain of the resource (Arabic, Church Slavonic, Greek, etc.) | 
-| **Feedback type** | Positive (👍) / Negative (👎) |+| **Feedback Type** | Positive (👍) / Negative (👎) |
 | **Note** | Additional comment provided by the Reviewer | | **Note** | Additional comment provided by the Reviewer |
-| **Reviewer** | Username of the reviewer who submitted the evaluation | +| **Reviewer** | Username of the Reviewer who submitted the evaluation | 
-| **Date and time** | Timestamp of the feedback submission |+| **Date and Time** | Timestamp of feedback submission |
  
-The export function provides the WP Lead with a control and documentation tool, also useful for reporting activities and project progress verification.+The export is designed to provide the WP Lead with a control and documentation tool, also useful for reporting purposes and for monitoring project progress.
  
 ---- ----
  
-===== Data Traceability and Security =====+===== Traceability and Data Security =====
  
-All feedback is persistently stored in the DaMSym database, with cross-references to the Reviewer user ID and the evaluated result. +All feedback entries are persistently recorded within the DaMSym database, with cross-reference to the Reviewer’s user ID and the evaluated result. 
-The system guarantees complete traceability of reviews, in compliance with the security and privacy policies adopted by ITSERR and RESILIENCE. + 
-Sensitive information (such as user IDs and timestamps) is processed exclusively for technical monitoring purposes and is not made publicly accessible.+The system guarantees full traceability of revisions, in compliance with the security and privacy policies adopted by ITSERR and RESILIENCE. 
 + 
 +Sensitive information (such as user ID and timestamp) is processed exclusively for technical monitoring purposes and is not made publicly available. 
 + 
 +----
  
damsym/feedback_and_ratings.1768490806.txt.gz · Last modified: by fincons