---
auto_generated: true
created: 2026-05-18
manual_updated_at: 2026-05-18
modified: 2026-05-18
name: User_Manual
status: active
tags:
- domain/ai
- domain/analytics
- status/active
- tech/azure-ad
- tech/celery
- tech/claude
- tech/nextjs
- tech/react
- type/sop
type: sop
---

# Amazon AI Transcreation Platform - User Manual

## What This Tool Does

The Amazon AI Transcreation Platform is an AI-powered solution designed to adapt Amazon marketing copy across 12 European locales. It replaces the previous manual LibreChat workflow with a structured, one-click multi-locale processing system.

Key capabilities include:
- **Automated Transcreation**: Uses Claude LLM agents to adapt marketing copy for different regions while maintaining brand voice.
- **Real-time Monitoring**: Track the status of transcreation jobs in real-time via the dashboard.
- **In-App Review**: Review, edit, and approve translated content directly within the platform.
- **Structured Job Management**: Upload source files, select locales, and manage outputs in a unified interface.

## Who Uses It

- **Localization Managers**: Oversee translation projects and manage quality across multiple locales.
- **Marketing Teams**: Adapt marketing copy for European markets without manual translation workflows.
- **QA Specialists**: Review AI-generated translations for accuracy and brand compliance.
- **Administrators**: Manage user access and system configurations.

## How to Access

1. Navigate to the platform URL (e.g., `http://localhost:3000` or the deployed staging/production URL).
2. If not already logged in, you will be redirected to the **Login** page.
3. Authenticate using your corporate credentials (via Azure AD SSO if enabled).
4. Upon successful authentication, you will be redirected to the **Dashboard**.

## Main Workflows

### Workflow 1: Creating a Transcreation Job

1. **Navigate to the Job Wizard**: From the Dashboard, click on "New Job" or navigate to the Job Wizard section.
2. **Upload Source Files**: 
   - Click "Upload" and select the marketing copy files (e.g., .txt, .docx, or .json).
   - Files are stored in `/storage` on the backend.
3. **Select Target Locales**: 
   - Choose the 12 European locales you wish to target (e.g., de_DE, fr_FR, es_ES, etc.).
   - Select the marketing channels (e.g., Email, Social Media, Product Descriptions).
4. **Configure Settings**: 
   - Choose the LLM model (default: `claude-sonnet-4-6`).
   - Adjust any specific tone or style guidelines if available.
5. **Launch Job**: Click "Start Transcreation".
   - The job is queued in Celery and processed with 4 concurrent workers.
   - You can monitor progress in the "Monitor" tab.

### Workflow 2: Monitoring Job Progress

1. **Go to Monitor**: Navigate to the "Monitor" section from the Dashboard.
2. **View Job Status**: 
   - Jobs will show statuses: `QUEUED`, `PROCESSING`, `COMPLETED`, or `FAILED`.
   - Use the polling mechanism (every 3 seconds) to see real-time updates.
3. **Check Details**: Click on a job to view details, including progress bars and logs.

### Workflow 3: Reviewing and Approving Output

1. **Navigate to Review**: Go to the "Review" section once jobs are completed.
2. **Select Job**: Choose a completed job from the list.
3. **Compare Source and Output**: 
   - View side-by-side comparisons of source copy and AI-generated translations.
   - Use the built-in editor to make manual adjustments if necessary.
4. **Approve or Reject**: 
   - Click "Approve" to finalize the content for export.
   - Click "Reject" to send the job back for reprocessing or manual intervention.

### Workflow 4: Exporting Final Content

1. **Navigate to Output**: Go to the "Output" section.
2. **Select Approved Jobs**: Choose the jobs you want to export.
3. **Download/Export**: 
   - Export the final translations in the desired format (e.g., JSON, CSV).
   - Files are stored in `/storage/output` by default.

## FAQ

### Q: How are translations generated?
A: Translations are generated using the Claude LLM (via Anthropic API) configured in the environment variables. The system adapts marketing copy while preserving brand tone.

### Q: What if a translation fails?
A: Failed jobs will show a `FAILED` status. Check the job logs in the Monitor tab for details. You can restart the job or manually edit the output in the Review section.

### Q: Can I customize the AI's tone?
A: Currently, the tone is controlled via the model selection (`claude-sonnet-4-6`). Future updates may include tone presets.

### Q: How many concurrent jobs can run?
A: The system is configured with 4 concurrent Celery workers. Additional jobs will queue until resources are available.

### Q: Is my data secure?
A: Yes, the platform supports Azure AD SSO for authentication. Data is stored in secure volumes (`pgdata` for DB, `/storage` for files).

### Q: How do I access the Admin panel?
A: Admin access is restricted to users with admin roles. Contact your system administrator to grant access.

## Related
- [[01 Projects/amazon-transcreation/DEVELOPER_MANUAL.md]]