Repository navigation
UC‐04
| Field | Value |
|---|---|
| Use Case Number: | UC 4 |
| Use Case Name: | Review, Edit Translated Content and Audio Guide |
| Actor(s): | Admin / Museum Staff |
| Maturity: | Focused / Completed |
| Summary: | Allows the Admin or Museum Staff to preview, edit translated content, regenerate the Audio Guide using Text-to-Speech (TTS) services, and publish content to the visitor mobile application. |
| Basic Course of Events: | 1. Admin/Staff accesses the "Translation and Audio Guide Management" feature. 2. The system displays a list of translations with filter options (language, approval status, exhibit). 3. Admin/Staff selects a translation to review. 4. The system displays the translated text and plays the current Audio Guide file for preview. 5. Admin/Staff checks the quality of both the text content and audio. 6. Admin/Staff selects "Approve & Publish". 7. The system updates the translation status to "Published". 8. The system synchronizes the updated content with the visitor mobile application. 9. The use case ends. |
| Alternative Paths: |
4.1. Edit Translated Content: 1. Admin selects "Edit", updates the translated text, and clicks "Save". 2. The system updates the Audio Guide status to "Needs Update". 3. Admin selects "Regenerate Audio Guide"; the system invokes the TTS service to generate a new audio file and plays a preview. 4. Resume at Step 5 of the Basic Course of Events. 4.2. Regenerate Audio Guide Without Editing Text: 1. Admin selects "Regenerate Audio Guide". 2. The system invokes the TTS service to synthesize a new audio file from existing text and plays a preview. 3. Resume at Step 5 of the Basic Course of Events. |
| Exception Paths: |
4.3. Missing Audio Guide File: 1. The system detects that no Audio Guide file exists for this translation and displays the notification: "Audio Guide not generated". 2. The system prompts the Admin to click "Regenerate Audio Guide". 4.4. TTS Service Error: 1. The system fails to connect to or invoke the Text-to-Speech (TTS) service. 2. The system displays an error message: "Unable to generate Audio Guide, please try again later" and retains the current data. |
| Extension Points: | - Generate_Audio_On_Edit: Triggered when translated content is edited and saved successfully (requiring audio file regeneration). - Publish_Content: Triggered when translated content and the Audio Guide are approved for publication (synchronizing data with the visitor mobile application). |
| Triggers: | Admin or Museum Staff selects a translation requiring review or update from the management list. |
| Assumptions: | - The Text-to-Speech (TTS API) service is stable and ready to respond. - The system has pre-stored original texts and their corresponding translation files. |
| Preconditions: | - The user is logged into the system with Admin or Museum Staff privileges. - The translation to be reviewed already exists in the database. |
| Postconditions: | - Translated content is successfully updated (if modified). - The Audio Guide file is newly generated or updated accordingly. - The translation and Audio Guide are approved and published to the visitor mobile application. |
