---
auto_generated: true
created: 2026-05-18
manual_updated_at: 2026-05-18
modified: 2026-05-18
name: User_Manual
status: active
tags:
- client/hm
- status/active
- tech/flask
- tech/python
- type/sop
type: sop
---

# H&M EMS Product Review Tool — User Manual

## 1. What This Tool Does

The H&M EMS Product Review Tool is a web-based application that allows client teams to review, edit, and approve product data (names and prices) for multiple international markets. It reads campaign data from JSON files and displays it in a structured, multi-language grid. Key capabilities include:

- **Reviewing Product Data**: View product names and prices for English (GB) alongside up to 4 other target languages simultaneously.
- **Inline Editing**: Modify product names or prices directly in the interface for any selected language.
- **Approval Workflow**: Approve changes with a single click. Approved items are locked, saved to the master JSON, and logged.
- **Visual Verification**: View product images with a click-to-enlarge feature to verify visual context.
- **Campaign Switching**: Easily switch between different JSON campaign files.

## 2. Who Uses It

This tool is designed for:
- **Product Data Analysts**: Who need to verify translation accuracy and pricing consistency.
- **Localisation Managers**: Who oversee the approval of content for specific regions.
- **Marketing Teams**: Who review campaign imagery and product positioning.

## 3. How to Access

### Prerequisites
- A web browser (Chrome, Firefox, Edge, or Safari).
- Network access to the deployed server.

### Login
1. Navigate to the application URL (e.g., `http://your-server/hm-ems-report`).
2. You will be presented with a login screen.
3. Enter your credentials:
   - **Username**: `admin3_M`
   - **Password**: `Pa$$w0rd2026_!`
   *Note: In production, these credentials should be changed to match your specific environment settings.*
4. Click **Login** to access the dashboard.

## 4. Main Workflows

### Workflow 1: Selecting a Campaign
1. On the main dashboard, locate the **Campaign Selector** (usually a dropdown or list at the top of the page).
2. Click to reveal available JSON campaign files from the `Master_Json/` directory.
3. Select the desired campaign (e.g., `1022A.json` or `2023.json`).
4. The product table will load with data from that specific campaign.

### Workflow 2: Reviewing and Editing Product Data
1. **Select Languages**: 
   - Use the language selector to choose up to 4 target languages (e.g., `de-de`, `fr-fr`, `es-es`).
   - The **English (GB)** column is fixed and always visible as a reference.
2. **Review Data**: 
   - Scroll through the table to inspect Product Names and Prices for the selected languages.
   - Compare translations against the English reference.
3. **Edit**: 
   - Click on any editable cell (Product Name or Price) for a non-English language.
   - Type the new value.
   - Press `Enter` or click outside the cell to save the local change.

### Workflow 3: Approving Changes
1. After verifying and editing the necessary fields:
   - Locate the **Approval Column** (typically contains a checkmark icon or button).
   - Click the **Tick/Approve button** for the specific article/language pair.
2. **Confirmation**: 
   - The row or cell will visually indicate it has been approved (e.g., greyed out or locked).
   - The change is automatically saved to the master JSON file.
   - An entry is added to the changelog file.
3. **Undo**: 
   - If an approval was made in error, click the **Unapprove** button to unlock the field and revert to the editable state.

### Workflow 4: Viewing Product Images
1. In each row, locate the **Image Column**.
2. **Multiple Images**: 
   - If a product has multiple campaign images, thumbnails will be displayed.
3. **Preview**: 
   - Click on any image thumbnail.
   - A popup overlay will appear showing the full-size image for detailed inspection.
4. Close the popup by clicking the **X** or clicking outside the image.

## 5. FAQ

**Q: What happens if I leave the page without approving edits?**
A: Edits made in the text fields are only saved to the server when you click the **Approve** button. If you leave the page, unsaved changes will be lost.

**Q: Can I edit the English (GB) column?**
A: No. The English (GB) column is a fixed reference for comparison and cannot be edited directly in this tool.

**Q: How do I know my changes have been saved?**
A: Once you click the Approve button, the cell locks, and the row/image typically updates visually to confirm the action. The change is also recorded in the backend changelog.

**Q: What if the images don't load?**
A: Ensure the `IMAGE_BASE_PATH` is correctly configured in the environment. Check the console for any 404 errors. The tool looks for images in `{year}/{campaign}/Automation_LR/`.

**Q: Can I select more than 4 languages?**
A: No, the tool is optimized for side-by-side comparison of up to 4 target languages plus the English reference to maintain readability.

## Related
- [[01 Projects/hm_ems_report/DEVELOPER_MANUAL.md]]