# chan-dev-beginner/voodoo_integration_system architecture

> Architecture diagram of the GitHub repository chan-dev-beginner/voodoo_integration_system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chan-dev-beginner/voodoo_integration_system
- Repository: https://github.com/chan-dev-beginner/voodoo_integration_system

## Overview

Voodoo eSports Café is a browser-based café POS and management app served through a small PHP entry point. Staff sign in, then the controller routes their role-specific actions through POS/ordering, inventory, restocking, and shift-order workflows; the model holds the operational state and persists orders and restock requests in browser storage. The view renders these workflows, including the printable shift summary. The README also documents backup, search, and responsive-layout capabilities. Evidence is limited to the excerpts and README; MySQL schema usage and unsampled integrations are not established.

Main entry points: [`Controller/AppController.js`](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Controller/AppController.js) (Action controller), [`Controller/AppBootstrap.js`](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Controller/AppBootstrap.js) (Client bootstrap), [`View/AppView.js`](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js) (Page renderer), [`Model/AppModel.js`](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js) (Application state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["PHP entry"]
  node_php_entry["Application entry<br/>[index.php]"]
  node_config["App configuration<br/>[config.php]"]
  node_page_shell["Page shell<br/>[index.php]"]
end

subgraph group_client["Browser application"]
  node_bootstrap["Client bootstrap<br/>[AppBootstrap.js]"]
  node_controller["Action controller<br/>[AppController.js]"]
end

subgraph group_workflow["Café workflows"]
  node_model["Application state<br/>[AppModel.js]"]
  node_catalog_stock["Catalog and stock<br/>[AppModel.js]"]
  node_cart_checkout["Cart and checkout<br/>[AppModel.js]"]
  node_orders["Shift orders<br/>[AppModel.js]"]
  node_restock["Restock requests<br/>[AppModel.js]"]
end

subgraph group_presentation["Interface"]
  node_view["Page renderer<br/>[AppView.js]"]
  node_pos_ordering["POS and ordering<br/>[AppView.js]"]
  node_inventory_view["Inventory and alerts<br/>[AppView.js]"]
  node_restock_view["Restock screens<br/>[AppView.js]"]
  node_shift_view["Shift log and summary<br/>[AppView.js]"]
  node_admin_tools["Backup and export<br/>[AppController.js]"]
end

node_staff(("Admin or barista"))
node_browser_storage[("Browser storage")]

node_staff -->|"opens app"| node_page_shell
node_php_entry -->|"loads config"| node_config
node_php_entry -->|"includes page"| node_page_shell
node_page_shell -->|"loads scripts"| node_bootstrap
node_bootstrap -->|"creates state"| node_model
node_bootstrap -->|"creates renderer"| node_view
node_bootstrap -->|"creates controller"| node_controller
node_controller -->|"authenticates and updates"| node_model
node_controller -->|"routes and renders"| node_view
node_view -->|"reads application state"| node_model
node_controller -->|"manages products"| node_catalog_stock
node_controller -->|"updates cart and confirms"| node_cart_checkout
node_cart_checkout -->|"records completed order"| node_orders
node_controller -->|"approves or rejects"| node_restock
node_model -->|"persists orders and requests"| node_browser_storage
node_controller -->|"selects workflow"| node_pos_ordering
node_controller -->|"routes inventory views"| node_inventory_view
node_controller -->|"routes restock view"| node_restock_view
node_controller -->|"routes shift views"| node_shift_view
node_controller -->|"handles backup actions"| node_admin_tools
node_view -->|"renders summary"| node_shift_view
node_staff -->|"submits actions"| node_controller

click node_php_entry "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/index.php"
click node_config "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/config.php"
click node_page_shell "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/index.php"
click node_bootstrap "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Controller/AppBootstrap.js"
click node_controller "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Controller/AppController.js"
click node_model "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js"
click node_catalog_stock "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js"
click node_cart_checkout "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js"
click node_orders "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js"
click node_restock "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js"
click node_view "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js"
click node_pos_ordering "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js"
click node_inventory_view "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js"
click node_restock_view "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js"
click node_shift_view "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js"
click node_admin_tools "https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Controller/AppController.js"

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_php_entry,node_config,node_page_shell toneBlue
class node_bootstrap,node_controller,node_browser_storage toneAmber
class node_model,node_catalog_stock,node_cart_checkout,node_orders,node_restock toneMint
class node_view,node_pos_ordering,node_inventory_view,node_restock_view,node_shift_view,node_admin_tools toneRose
class node_staff toneIndigo
```

## Components

### PHP entry

- [Application entry](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/index.php): `index.php`
- [App configuration](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/config.php): `Model/config.php`
- [Page shell](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/index.php): `View/index.php`

### Browser application

- [Client bootstrap](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Controller/AppBootstrap.js): `Controller/AppBootstrap.js`
- [Action controller](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Controller/AppController.js): `Controller/AppController.js`

### Café workflows

- [Application state](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js): `Model/AppModel.js`
- [Catalog and stock](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js): `Model/AppModel.js`
- [Cart and checkout](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js): `Model/AppModel.js`
- [Shift orders](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js): `Model/AppModel.js`
- [Restock requests](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Model/AppModel.js): `Model/AppModel.js`

### Interface

- [Page renderer](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js): `View/AppView.js`
- [POS and ordering](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js): `View/AppView.js`
- [Inventory and alerts](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js): `View/AppView.js`
- [Restock screens](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js): `View/AppView.js`
- [Shift log and summary](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/View/AppView.js): `View/AppView.js`
- [Backup and export](https://github.com/chan-dev-beginner/voodoo_integration_system/blob/main/Controller/AppController.js): `Controller/AppController.js`

### Other components

- **Admin or barista**
- **Browser storage**

## Connections

- Admin or barista → Page shell: opens app (evidence: `View/index.php`)
- Application entry → App configuration: loads config (evidence: `index.php`)
- Application entry → Page shell: includes page (evidence: `index.php`)
- Page shell → Client bootstrap: loads scripts (evidence: `View/index.php`)
- Client bootstrap → Application state: creates state (evidence: `Controller/AppBootstrap.js`)
- Client bootstrap → Page renderer: creates renderer (evidence: `Controller/AppBootstrap.js`)
- Client bootstrap → Action controller: creates controller (evidence: `Controller/AppBootstrap.js`)
- Action controller → Application state: authenticates and updates (evidence: `Controller/AppController.js`)
- Action controller → Page renderer: routes and renders (evidence: `Controller/AppController.js`)
- Page renderer → Application state: reads application state (evidence: `View/AppView.js`)
- Action controller → Catalog and stock: manages products (evidence: `Controller/AppController.js`)
- Action controller → Cart and checkout: updates cart and confirms (evidence: `Controller/AppController.js`)
- Cart and checkout → Shift orders: records completed order (evidence: `Model/AppModel.js`)
- Action controller → Restock requests: approves or rejects (evidence: `Controller/AppController.js`)
- Application state → Browser storage: persists orders and requests (evidence: `Model/AppModel.js`)
- Action controller → POS and ordering: selects workflow (evidence: `Controller/AppController.js`)
- Action controller → Inventory and alerts: routes inventory views (evidence: `Controller/AppController.js`)
- Action controller → Restock screens: routes restock view (evidence: `Controller/AppController.js`)
- Action controller → Shift log and summary: routes shift views (evidence: `Controller/AppController.js`)
- Action controller → Backup and export: handles backup actions (evidence: `Controller/AppController.js`)
- Page renderer → Shift log and summary: renders summary (evidence: `View/AppView.js`)
- Admin or barista → Action controller: submits actions
