# amangupta0709/lenstest architecture

> Architecture diagram of the GitHub repository amangupta0709/lenstest, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amangupta0709/lenstest
- Repository: https://github.com/amangupta0709/lenstest

## Overview

##### Project Type and Purpose
- This is a standalone backend service (no frontend) built with Spring Boot.
- Its primary purpose is to orchestrate and execute Cucumber-based tests against a MongoDB instance, expose a REST endpoint to trigger test runs, and store test results in MongoDB for later retrieval or reporting.

##### File Structure Analysis
Top-level directories:
- backend/ – all source code, configuration, and build scripts
- LICENSE, README.md – project metadata

Inside backend/:
- .mvn/, mvnw, pom.xml – Maven build wrapper and project descriptor
- src/main/java/com/db/lenstest/
– config/ (MongoDB & Cucumber configs)
– controller/ (REST API entrypoint)
– dto/ (data-transfer objects for requests & statuses)
– listener/ (ExtentCucumberListener to hook into Cucumber events)
– model/ (domain models for TestExecution, TestDocument, etc.)
– repository/ (Spring Data MongoDB repository)
– runner/ (custom TestCucumberRunner)
– service/ (TestOrchestrator coordinating test execution)
– steps/ (Cucumber step definitions)
– LenstestApplication.java (Spring Boot main class)
- src/main/resources/
– application.properties & chaintest.properties (service config)
– extent-*.xml/js/css (report styling/config)
– features/ (Cucumber feature files)
- src/test/java… – simple application context test

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Client
    Client["Client (REST Caller)"]:::external

    %% Configuration Layer
    subgraph "Configuration" 
        direction TB
        MongoConfig["MongoConfig"]:::config
        CucumberConfig["CucumberConfig"]:::config
        Props["application.properties\nchaintest.properties"]:::config
    end

    %% API Layer
    subgraph "API Layer"
        direction TB
        Controller["TestExecutionController"]:::api
        DTOs["DTOs\n(TestRequest, ExecutionStatus)"]:::api
    end

    %% Service Layer
    subgraph "Service Layer"
        direction TB
        Orchestrator["TestOrchestrator"]:::service
    end

    %% Execution Engine Layer
    subgraph "Execution Engine"
        direction TB
        Runner["TestCucumberRunner"]:::execution
        Listener["ExtentCucumberListener"]:::listener
        Features["Feature Files\n(mongo_connection.feature)"]:::execution
        Steps["Step Definitions\n(MongoConnectionSteps)"]:::execution
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        direction TB
        Repository["TestDocumentRepository"]:::persistence
        Models["Domain Models\n(TestExecution, TestDocument,\nTestCaseExecution)"]:::persistence
        MongoDB["MongoDB"]:::database
    end

    %% Main Flows
    Client -->|POST /tests| Controller
    Controller -->|"executeTests(TestRequest)"| Orchestrator
    Controller -->|returns ExecutionStatus| Client
    Orchestrator -->|"configure via CucumberConfig" | CucumberConfig
    Orchestrator -->|"configure via MongoConfig" | MongoConfig
    Orchestrator -->|"run tests"| Runner
    Runner -->|"loads"| Features
    Runner -->|"uses"| Steps
    Runner -->|"registers"| Listener
    Listener -->|"emits TestExecution model"| Orchestrator
    Orchestrator -->|"save()"| Repository
    Repository -->|writes| MongoDB
    Repository -->|"maps with"| Models

    %% Click Events
    click Controller "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/controller/TestExecutionController.java"
    click Orchestrator "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/service/TestOrchestrator.java"
    click Runner "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/runner/TestCucumberRunner.java"
    click Listener "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/listener/ExtentCucumberListener.java"
    click MongoConfig "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/config/MongoConfig.java"
    click CucumberConfig "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/config/CucumberConfig.java"
    click Repository "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/repository/TestDocumentRepository.java"
    click Models "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/model/TestExecution.java"
    click Models "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/model/TestDocument.java"
    click Models "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/model/TestCaseExecution.java"
    click DTOs "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/dto/TestRequest.java"
    click DTOs "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/dto/ExecutionStatus.java"
    click Steps "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/steps/MongoConnectionSteps.java"
    click Features "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/resources/features/mongo_connection.feature"
    click Props "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/resources/application.properties"
    click Props "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/resources/chaintest.properties"
    click Props "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/resources/extent-config.xml"
    click Props "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/resources/extent.css"
    click Props "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/resources/extent.js"
    click Props "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/resources/extent.properties"
    click Lenstest "https://github.com/amangupta0709/lenstest/blob/main/backend/src/main/java/com/db/lenstest/LenstestApplication.java"

    %% Styles
    classDef external fill:#f9f,stroke:#333,stroke-width:1px
    classDef config fill:#bbb,stroke:#333,stroke-width:1px
    classDef api fill:#bbf,stroke:#333,stroke-width:1px
    classDef service fill:#88f,stroke:#333,stroke-width:1px
    classDef execution fill:#8f8,stroke:#333,stroke-width:1px
    classDef listener fill:#7f7,stroke:#333,stroke-width:1px
    classDef persistence fill:#f90,stroke:#333,stroke-width:1px
    classDef database fill:#fa0,stroke:#333,stroke-width:1px
```
