> For the complete documentation index, see [llms.txt](https://mozarkdocs.gitbook.io/appx_documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mozarkdocs.gitbook.io/appx_documentation/test-infrastructure-documentation/getting-started/overview.md).

# Overview

## Product Overview

Use this page to understand the portal's main modules and how they work together.

### Architecture at a glance

The Testing Portal is a single-page web application connected to several backend services.

You do not need deep backend knowledge to use it effectively.

This model helps explain why some actions feel instant, while others take longer.

Launching a session is usually immediate.

Loading session video can take longer because recorded assets are fetched separately.

| Service                   | What it does                                                                               | When you interact with it                                          |
| ------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
| Session Service           | Creates and tracks test sessions. Stores metadata, notes, and configuration.               | Launching sessions, viewing session history, editing session names |
| Manual Test Service       | Manages bugs filed against sessions and video timestamp markers.                           | **Bugs** tab, **Video** tab markers                                |
| Tags Service              | Creates and assigns searchable labels to sessions.                                         | Adding or removing tags in session rows                            |
| Files Service             | Stores app builds and test artifacts with metadata.                                        | **File Management** page                                           |
| Admin Control Panel (ACP) | Manages organizations, apps, projects, and user assignments.                               | Organization, app, and project selector in the top navigation      |
| Optics AI Service         | Runs AI browser agents through WebSocket connections for live interaction and exploration. | **Interact** page, **Explorer** page                               |

### Main modules

#### Interactive testing

Launch live manual test sessions on web, mobile, and TV platforms.

Capture bugs and screenshots in real time.

#### Automation testing

Connect Playwright and Appium test suites to the platform's remote hubs.

View automation results alongside interactive sessions.

#### Optics AI automation

Use natural language to control a live browser in **Interact**.

Use **Explorer** to let AI discover and test application flows autonomously.

#### Sessions

View all sessions across platforms in one searchable list.

Filter, paginate, and open sessions to review video, screenshots, bugs, and notes.

#### File Management

Upload app builds, APKs, IPAs, and other test assets.

Tag files with metadata, then download or share them as needed.

#### External integrations

Open the Mozark Dashboard and Test Case Repository from the sidebar.

These links open the rest of the quality suite in one click.

### Navigation structure

The portal includes three persistent navigation elements.

#### Top navigation bar

The top bar spans the full width of the portal.

It includes the Mozark logo, a light and dark theme toggle, and your user menu.

Use the user menu to switch organization, app, and project context.

You can also open the Admin portal from there.

#### Sidebar

The sidebar runs vertically on the left.

It is collapsible.

Use the arrow at the bottom to switch to icon-only mode and free more horizontal space.

The sidebar contains top-level navigation items.

External links such as **Dashboard** and **Test Case Repository** open in a new tab.

#### Breadcrumbs

Breadcrumbs appear at the top of the main content area.

They show your current location in the portal hierarchy.

For example: `Interactive → Sessions → Session Summary`

Select any breadcrumb item to go back to that level.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://mozarkdocs.gitbook.io/appx_documentation/test-infrastructure-documentation/getting-started/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
