---
auto_generated: true
created: 2026-05-18
manual_updated_at: 2026-05-18
modified: 2026-05-18
name: User_Manual
status: active
tags:
- client/oliver
- domain/security
- tech/arq
- tech/azure-ad
- tech/docker
- tech/fastapi
- tech/gemini
- tech/nextjs
- tech/python
- tech/react
- type/sop
type: sop
---

# Oliver DeckForge User Manual

## What This Tool Does
Oliver DeckForge is an enterprise-grade AI-powered presentation generator. It allows you to create professional slide decks from various inputs such as text prompts, uploaded documents (DOCX, PPTX), images, or even URLs. The platform features multi-tenant architecture for data isolation, custom template support, and role-based access control (RBAC).

## Who Uses It
- **Super Admins**: Manage the entire platform, create clients, and oversee system health.
- **Client Admins**: Manage individual client workspaces, upload custom master templates, and control user access within their organization.
- **Users**: Create, edit, and export presentations using pre-built or custom templates.

## How to Access
1. **Development Mode**: Run `docker-compose up` in the project root. Access the web interface at `http://localhost:3000`. Authentication bypasses Azure AD if no tenant ID is set.
2. **Production Mode**: Access the public domain configured in `ALLOWED_ORIGINS` and `AZURE_AD_REDIRECT_URI`. Login is handled via Azure AD SSO.

## Main Workflows

### 1. Generating a Presentation from Text
1. Log in to the Dashboard.
2. Click **New Presentation**.
3. Select **Text Prompt** as the source.
4. Enter your topic or description in the input field.
5. Specify the number of slides (e.g., 10).
6. Click **Generate**. The AI worker will process your request via SSE (Server-Sent Events) streaming updates.
7. Once complete, preview the slides and click **Export** to download as PDF or PPTX.

### 2. Uploading a Document to Convert
1. Navigate to **New Presentation**.
2. Select **Upload Document**.
3. Choose a file (supports DOCX, PPTX, images).
4. Set the desired slide count.
5. Click **Generate**. The system will parse the document structure and content using the `PARSING_MODEL` (default: Gemini 2.5 Flash Lite).

### 3. Using Custom Master Templates
*Available to Client Admins and Super Admins*
1. Go to **Settings** > **Templates**.
2. Upload a `.pptx` file as your Master Deck.
3. The system will automatically parse the layouts into reusable React components.
4. Return to the dashboard and select this template when creating new presentations to apply consistent branding and layout structures.

### 4. Managing Users (Admins Only)
1. Navigate to **Admin Panel** > **Users**.
2. Assign roles: Super Admin, Client Admin, or User.
3. Configure RBAC permissions for specific clients or the entire platform.

## FAQ

**Q: Why is my presentation generation taking so long?**
A: Complex documents or large slide counts are processed by background workers (`arq`). Check the worker logs in the Docker container if it exceeds 5 minutes.

**Q: Can I use my own AI models?**
A: Currently, the system is configured to use Google Gemini (Gemini 3.1 Pro for quality, Gemini 2.5 Flash Lite for parsing). You can change the model in `.env` under `GOOGLE_MODEL` and `PARSING_MODEL`.

**Q: How do I reset my password?**
A: If using Dev Auth (local), the password is set in `DEV_AUTH_PASSWORD` in `.env`. If using Azure AD, reset via your organization's Azure portal.

**Q: Is my data private?**
A: Yes. The architecture enforces multi-tenant isolation. Client data is strictly separated in the Postgres database. Anonymous tracking is disabled by default (`DISABLE_ANONYMOUS_TRACKING=true`).

## Related

- [[01 Projects/presenton/USER_MANUAL]]
- [[01 Projects/ppt-tool/USER_MANUAL.md]]
- [[01 Projects/presenton/USER_MANUAL.md]]