# pinaki-das-sage/mini-erp architecture

> Architecture diagram of the GitHub repository pinaki-das-sage/mini-erp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pinaki-das-sage/mini-erp
- Repository: https://github.com/pinaki-das-sage/mini-erp

## Overview

Mini ERP is currently a shared PHP foundation, not an implemented wholesale-distribution ERP: the README says inventory, purchasing, sales and logistics services remain unimplemented. The runtime workflow is HTTP request → Kernel routing → browser session or bearer API handling → shared services and Oracle → rendered page or API response. The graph also includes company/user administration, permissions, notes, migrations and seeding. ERP business stages are omitted because the repository documents them as planned work; unsampled relationships are not inferred beyond indexed references and README statements.

Main entry points: [`src/shared/Kernel.php`](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/Kernel.php) (Request kernel), [`src/shared/Api.php`](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/Api.php) (REST API), [`src/shared/security/AuthService.php`](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/AuthService.php) (Browser authentication), [`src/shared/database/Connection.php`](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/database/Connection.php) (Database interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Request handling"]
  node_http["HTTP entry<br/>[index.php]"]
  node_kernel["Request kernel<br/>[Kernel.php]"]
  node_api["REST API<br/>[Api.php]"]
  node_renderer["View renderer<br/>[Renderer.php]"]
  node_templates["Shared views"]
end

subgraph group_identity["Identity and access"]
  node_auth["Browser authentication<br/>[AuthService.php]"]
  node_actor["Company actor<br/>[Actor.php]"]
  node_tokens["Bearer tokens<br/>[TokenService.php]"]
  node_users["User administration<br/>[UserService.php]"]
  node_permissions["Permission checks<br/>[Authorization.php]"]
end

subgraph group_runtime["Shared services"]
  node_notes["Versioned notes<br/>[NeutralNote.php]"]
  node_company["Company bootstrap"]
  node_seeder["Training accounts<br/>[Seeder.php]"]
end

subgraph group_persistence["Oracle persistence"]
  node_migrations["Schema migrations"]
  node_transactions["Transactions"]
  node_connection["Database interface<br/>[Connection.php]"]
  node_oci["OCI adapter<br/>[OciConnection.php]"]
end

node_user(("User"))
node_oracle[("Oracle database")]

node_user -->|"sends requests"| node_http
node_http -->|"dispatches to"| node_kernel
node_kernel -->|"routes API"| node_api
node_kernel -->|"authenticates browser"| node_auth
node_kernel -->|"handles settings"| node_users
node_kernel -->|"renders pages"| node_renderer
node_renderer -->|"renders templates"| node_templates
node_api -->|"authenticates bearer"| node_tokens
node_tokens -->|"validates identity"| node_auth
node_auth -->|"creates actor"| node_actor
node_api -->|"administers users"| node_users
node_api -->|"checks grants"| node_permissions
node_api -->|"serves notes"| node_notes
node_kernel -->|"loads note page"| node_notes
node_company -->|"seeds accounts"| node_seeder
node_migrations -->|"executes schema"| node_connection
node_transactions -->|"controls transactions"| node_connection
node_oci -->|"implements interface"| node_connection
node_oci -.->|"queries database"| node_oracle

click node_http "https://github.com/pinaki-das-sage/mini-erp/blob/main/public/index.php"
click node_kernel "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/Kernel.php"
click node_api "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/Api.php"
click node_renderer "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/view/Renderer.php"
click node_templates "https://github.com/pinaki-das-sage/mini-erp/tree/main/views/shared"
click node_auth "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/AuthService.php"
click node_actor "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/Actor.php"
click node_tokens "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/TokenService.php"
click node_users "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/UserService.php"
click node_permissions "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/Authorization.php"
click node_notes "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/NeutralNote.php"
click node_company "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/CompanyBootstrap.php"
click node_seeder "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/Seeder.php"
click node_migrations "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/database/MigrationRunner.php"
click node_transactions "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/database/TransactionManager.php"
click node_connection "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/database/Connection.php"
click node_oci "https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/database/OciConnection.php"

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_http,node_kernel,node_api,node_renderer,node_templates,node_user toneBlue
class node_auth,node_actor,node_tokens,node_users,node_permissions,node_oracle toneAmber
class node_notes,node_company,node_seeder toneMint
class node_migrations,node_transactions,node_connection,node_oci toneRose
```

## Components

### Request handling

- [HTTP entry](https://github.com/pinaki-das-sage/mini-erp/blob/main/public/index.php): `public/index.php`
- [Request kernel](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/Kernel.php): `src/shared/Kernel.php`
- [REST API](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/Api.php): `src/shared/Api.php`
- [View renderer](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/view/Renderer.php): `src/shared/view/Renderer.php`
- [Shared views](https://github.com/pinaki-das-sage/mini-erp/tree/main/views/shared): `views/shared`

### Identity and access

- [Browser authentication](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/AuthService.php): `src/shared/security/AuthService.php`
- [Company actor](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/Actor.php): `src/shared/security/Actor.php`
- [Bearer tokens](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/TokenService.php): `src/shared/security/TokenService.php`
- [User administration](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/UserService.php): `src/shared/security/UserService.php`
- [Permission checks](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/Authorization.php): `src/shared/security/Authorization.php`

### Shared services

- [Versioned notes](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/NeutralNote.php): `src/shared/NeutralNote.php`
- [Company bootstrap](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/security/CompanyBootstrap.php): `src/shared/security/CompanyBootstrap.php`
- [Training accounts](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/Seeder.php): `src/shared/Seeder.php`

### Oracle persistence

- [Schema migrations](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/database/MigrationRunner.php): `src/shared/database/MigrationRunner.php`
- [Transactions](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/database/TransactionManager.php): `src/shared/database/TransactionManager.php`
- [Database interface](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/database/Connection.php): `src/shared/database/Connection.php`
- [OCI adapter](https://github.com/pinaki-das-sage/mini-erp/blob/main/src/shared/database/OciConnection.php): `src/shared/database/OciConnection.php`

### Other components

- **User**
- **Oracle database**

## Connections

- User → HTTP entry: sends requests (evidence: `README.md`)
- HTTP entry → Request kernel: dispatches to (evidence: `public/index.php`)
- Request kernel → REST API: routes API (evidence: `src/shared/Kernel.php`)
- Request kernel → Browser authentication: authenticates browser (evidence: `src/shared/Kernel.php`)
- Request kernel → User administration: handles settings (evidence: `src/shared/Kernel.php`)
- Request kernel → View renderer: renders pages (evidence: `src/shared/Kernel.php`)
- View renderer → Shared views: renders templates (evidence: `README.md`)
- REST API → Bearer tokens: authenticates bearer (evidence: `src/shared/Api.php`)
- Bearer tokens → Browser authentication: validates identity (evidence: `src/shared/security/TokenService.php`)
- Browser authentication → Company actor: creates actor (evidence: `src/shared/security/AuthService.php`)
- REST API → User administration: administers users (evidence: `src/shared/Api.php`)
- REST API → Permission checks: checks grants (evidence: `src/shared/Api.php`)
- REST API → Versioned notes: serves notes (evidence: `src/shared/Api.php`)
- Request kernel → Versioned notes: loads note page (evidence: `src/shared/Kernel.php`)
- Company bootstrap → Training accounts: seeds accounts (evidence: `src/shared/security/CompanyBootstrap.php`)
- Schema migrations → Database interface: executes schema (evidence: `src/shared/database/MigrationRunner.php`)
- Transactions → Database interface: controls transactions (evidence: `src/shared/database/TransactionManager.php`)
- OCI adapter → Database interface: implements interface (evidence: `src/shared/database/OciConnection.php`)
- OCI adapter → Oracle database: queries database
