# 12karthi34/fricationapp architecture

> Architecture diagram of the GitHub repository 12karthi34/fricationapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/12karthi34/fricationapp
- Repository: https://github.com/12karthi34/fricationapp

## Overview

This repository is a Python/Appium test automation framework for the Friction Android app, not the app itself. Its workflow is a Pytest test using a device driver, then page-object interactions and assertions against app screens; failures can capture screenshots for reports. The README also documents scenarios spanning protection, overlays, navigation, and app lifecycle. Some page modules are empty in the sampled excerpts, so their detailed calls and interactions are not inferred.

Main entry points: [`tests`](https://github.com/12karthi34/fricationapp/tree/main/tests) (Scenario Tests), [`conftest.py`](https://github.com/12karthi34/fricationapp/blob/main/conftest.py) (Pytest Fixture), [`pages/home_page.py`](https://github.com/12karthi34/fricationapp/blob/main/pages/home_page.py) (Home & Navigation), [`utils/logger.py`](https://github.com/12karthi34/fricationapp/blob/main/utils/logger.py) (Logger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Device Setup"]
  node_tests["Scenario Tests"]
  node_fixture["Pytest Fixture<br/>[conftest.py]"]
end

subgraph group_pages["Page Objects"]
  node_home["Home &amp; Navigation<br/>[home_page.py]"]
  node_protect["Protection Flows<br/>[protect_page.py]"]
  node_addapp["App Selection<br/>[add_app_page.py]"]
  node_overlay["Overlay &amp; Pause<br/>[overlay_page.py]"]
  node_base["Page Base<br/>[base_page.py]"]
end

subgraph group_support["Automation Support"]
  node_waits["Wait Helpers<br/>[waits.py]"]
  node_gestures["Gesture Helpers<br/>[gestures.py]"]
  node_driverfactory["Driver Factory<br/>[driver_factory.py]"]
  node_logger["Logger<br/>[logger.py]"]
end

subgraph group_evidence["Results"]
  node_screenshots["Failure Screenshots<br/>[conftest.py]"]
  node_allure["Allure Reports"]
  node_logs["Execution Logs"]
end

node_qa(("QA Engineer"))
node_appium["Appium Server"]
node_device["Android Device"]

node_qa -->|"runs"| node_tests
node_tests -.->|"requests driver"| node_fixture
node_fixture -->|"creates session"| node_appium
node_appium -->|"drives"| node_device
node_tests -.->|"uses pages"| node_home
node_home -->|"logs events"| node_logger
node_home -->|"interacts via driver"| node_device
node_fixture -->|"captures on failure"| node_screenshots
node_screenshots -->|"attaches image"| node_allure
node_logger -->|"writes"| node_logs
node_tests -.->|"scenario coverage"| node_protect
node_tests -.->|"scenario coverage"| node_addapp
node_tests -.->|"scenario coverage"| node_overlay
node_tests -.->|"reports results"| node_allure

click node_tests "https://github.com/12karthi34/fricationapp/tree/main/tests"
click node_fixture "https://github.com/12karthi34/fricationapp/blob/main/conftest.py"
click node_home "https://github.com/12karthi34/fricationapp/blob/main/pages/home_page.py"
click node_protect "https://github.com/12karthi34/fricationapp/blob/main/pages/protect_page.py"
click node_addapp "https://github.com/12karthi34/fricationapp/blob/main/pages/add_app_page.py"
click node_overlay "https://github.com/12karthi34/fricationapp/blob/main/pages/overlay_page.py"
click node_base "https://github.com/12karthi34/fricationapp/blob/main/pages/base_page.py"
click node_waits "https://github.com/12karthi34/fricationapp/blob/main/utils/waits.py"
click node_gestures "https://github.com/12karthi34/fricationapp/blob/main/utils/gestures.py"
click node_driverfactory "https://github.com/12karthi34/fricationapp/blob/main/utils/driver_factory.py"
click node_logger "https://github.com/12karthi34/fricationapp/blob/main/utils/logger.py"
click node_screenshots "https://github.com/12karthi34/fricationapp/blob/main/conftest.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_tests,node_fixture toneBlue
class node_home,node_protect,node_addapp,node_overlay,node_base toneAmber
class node_waits,node_gestures,node_driverfactory,node_logger,node_appium toneMint
class node_screenshots,node_allure,node_logs toneRose
class node_qa,node_device toneIndigo
```

## Components

### Device Setup

- [Scenario Tests](https://github.com/12karthi34/fricationapp/tree/main/tests): `tests`
- [Pytest Fixture](https://github.com/12karthi34/fricationapp/blob/main/conftest.py): `conftest.py`

### Page Objects

- [Home & Navigation](https://github.com/12karthi34/fricationapp/blob/main/pages/home_page.py): `pages/home_page.py`
- [Protection Flows](https://github.com/12karthi34/fricationapp/blob/main/pages/protect_page.py): `pages/protect_page.py`
- [App Selection](https://github.com/12karthi34/fricationapp/blob/main/pages/add_app_page.py): `pages/add_app_page.py`
- [Overlay & Pause](https://github.com/12karthi34/fricationapp/blob/main/pages/overlay_page.py): `pages/overlay_page.py`
- [Page Base](https://github.com/12karthi34/fricationapp/blob/main/pages/base_page.py): `pages/base_page.py`

### Automation Support

- [Wait Helpers](https://github.com/12karthi34/fricationapp/blob/main/utils/waits.py): `utils/waits.py`
- [Gesture Helpers](https://github.com/12karthi34/fricationapp/blob/main/utils/gestures.py): `utils/gestures.py`
- [Driver Factory](https://github.com/12karthi34/fricationapp/blob/main/utils/driver_factory.py): `utils/driver_factory.py`
- [Logger](https://github.com/12karthi34/fricationapp/blob/main/utils/logger.py): `utils/logger.py`

### Results

- [Failure Screenshots](https://github.com/12karthi34/fricationapp/blob/main/conftest.py): `conftest.py`
- **Allure Reports**
- **Execution Logs**

### Other components

- **QA Engineer**
- **Appium Server**
- **Android Device**

## Connections

- QA Engineer → Scenario Tests: runs (evidence: `README.md`)
- Scenario Tests → Pytest Fixture: requests driver
- Pytest Fixture → Appium Server: creates session (evidence: `conftest.py`)
- Appium Server → Android Device: drives
- Scenario Tests → Home & Navigation: uses pages
- Home & Navigation → Logger: logs events (evidence: `pages/home_page.py`)
- Home & Navigation → Android Device: interacts via driver (evidence: `pages/home_page.py`)
- Pytest Fixture → Failure Screenshots: captures on failure (evidence: `conftest.py`)
- Failure Screenshots → Allure Reports: attaches image (evidence: `conftest.py`)
- Logger → Execution Logs: writes (evidence: `utils/logger.py`)
- Scenario Tests → Protection Flows: scenario coverage (evidence: `README.md`)
- Scenario Tests → App Selection: scenario coverage (evidence: `README.md`)
- Scenario Tests → Overlay & Pause: scenario coverage (evidence: `README.md`)
- Scenario Tests → Allure Reports: reports results (evidence: `README.md`)
