# aradhyapatil/aillusion architecture

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

- Interactive diagram: https://gitdiagram.com/aradhyapatil/aillusion
- Repository: https://github.com/aradhyapatil/aillusion

## Overview

##### Project Type & Purpose
- The project is a web-based, immersive murder mystery experience.
- It is designed as an interactive, story-driven challenge where users (detectives) navigate through various themed HTML pages to uncover clues and solve a crime.
- The README emphasizes critical elements such as using AI-powered forensic analysis and the event’s narrative, but the core of the project consists of static HTML pages that deliver the immersive experience.

##### File Structure Analysis
- At the top level, you have multiple HTML files (e.g., BetsandBetrayals.html, BiotechBetrayal.html, etc.)—each representing a different mystery or narrative scenario.
- The index.html likely serves as the home or story selection page, allowing users to choose which mystery they wish to explore.
- The README.md provides the context and event details, highlighting the role of AI in analyzing clues even though the implementation details are not present in the file tree.
- There are no visible backend directories or configuration files, implying that the project is currently structured as a static site, possibly to be enhanced with dynamic content or integrated with AI tools separately.

##### Main Components of the System
a. User Interface Components:
- Home/Story Selection Page (index.html)
- Individual Mystery Pages (each of the provided HTML files represents a separate scenario such as “HauntedMansion” or “NeuralNetworkConspiracy”)
b. (Potential) AI & Forensics Integration:
c. Navigation & Flow Control:
- User-driven navigation between pages (from index.html to individual mystery scenario pages)
- A possible feedback loop where the user’s actions on story pages might eventually trigger AI-based evidence analysis.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "UI Components"
        direction TB
        index["Home - Story Selection"]:::ui
        subgraph "Mystery Scenario Pages"
            direction TB
            Bets["Mystery: Bets and Betrayals"]:::ui
            Biotech["Mystery: Biotech Betrayal"]:::ui
            Carnival["Mystery: Carnival of Shadows"]:::ui
            Haunted["Mystery: Haunted Mansion"]:::ui
            Lakeside["Mystery: Lakeside Lies and Deadly Ties"]:::ui
            Murder["Mystery: Murder at the Gala"]:::ui
            Neural["Mystery: Neural Network Conspiracy"]:::ui
        end
    end

    forensic["AI-Powered Forensics Engine"]:::external
    README["Documentation & Context"]:::doc

    %% Navigation from Home to each Mystery Scenario Page
    index -->|"selects"| Bets
    index -->|"selects"| Biotech
    index -->|"selects"| Carnival
    index -->|"selects"| Haunted
    index -->|"selects"| Lakeside
    index -->|"selects"| Murder
    index -->|"selects"| Neural
    
    %% Interaction between Mystery Pages and AI Forensics Engine
    Bets -->|"analyzes"| forensic
    Biotech -->|"analyzes"| forensic
    Carnival -->|"analyzes"| forensic
    Haunted -->|"analyzes"| forensic
    Lakeside -->|"analyzes"| forensic
    Murder -->|"analyzes"| forensic
    Neural -->|"analyzes"| forensic

    forensic -->|"returnsResults"| Bets
    forensic -->|"returnsResults"| Biotech
    forensic -->|"returnsResults"| Carnival
    forensic -->|"returnsResults"| Haunted
    forensic -->|"returnsResults"| Lakeside
    forensic -->|"returnsResults"| Murder
    forensic -->|"returnsResults"| Neural

    %% Documentation providing context and setup information
    README -->|"describes"| index
    README -->|"detailsConcept"| forensic

    %% Click Events
    click index "https://github.com/aradhyapatil/aillusion/blob/main/index.html"
    click Bets "https://github.com/aradhyapatil/aillusion/blob/main/BetsandBetrayals.html"
    click Biotech "https://github.com/aradhyapatil/aillusion/blob/main/BiotechBetrayal.html"
    click Carnival "https://github.com/aradhyapatil/aillusion/blob/main/CarnivalofShadows.html"
    click Haunted "https://github.com/aradhyapatil/aillusion/blob/main/HauntedMansion.html"
    click Lakeside "https://github.com/aradhyapatil/aillusion/blob/main/LakesideLiesandDeadlyTies.html"
    click Murder "https://github.com/aradhyapatil/aillusion/blob/main/MurderattheGala.html"
    click Neural "https://github.com/aradhyapatil/aillusion/blob/main/NeuralNetworkConspiracy.html"
    click README "https://github.com/aradhyapatil/aillusion/blob/main/README.md"

    %% Styles
    classDef ui fill:#87CEEB,stroke:#333,stroke-width:2px;
    classDef external fill:#FFA07A,stroke:#333,stroke-width:2px;
    classDef doc fill:#90EE90,stroke:#333,stroke-width:2px;
```
