# aliahsan9/businessos_ui architecture

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

- Interactive diagram: https://gitdiagram.com/aliahsan9/businessos_ui
- Repository: https://github.com/aliahsan9/businessos_ui

## Overview

BusinessOS Web is an Angular frontend for a multi-tenant business-management platform backed by a separate API. The principal user journey is authentication, guarded entry into the dashboard, then access to operational and analytical features. Routing and sampled feature-route files establish the navigation and permission boundaries; the README documents dashboard API data. Service-level behavior was not sampled, so the graph avoids asserting unshown calls between feature screens and services.

Main entry points: [`src/app/app.routes.ts`](https://github.com/aliahsan9/businessos_ui/blob/main/src/app/app.routes.ts) (Application routing), [`src/app/features/products`](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/products) (Products and categories), [`src/app/features/dashboard`](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/dashboard) (Dashboard), [`src/app/core/guards`](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/core/guards) (Access guards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and access"]
  node_routing["Application routing<br/>[app.routes.ts]"]
  node_auth["Authentication"]
  node_guards["Access guards"]
end

subgraph group_operations["Business operations"]
  node_catalog["Products and categories"]
  node_inventory["Inventory"]
  node_customers["Customers"]
  node_sales["Orders and sales"]
  node_quotations["Quotations"]
  node_purchasing["Suppliers and purchasing"]
  node_invoices["Invoices and payments"]
end

subgraph group_insight["Insights and finance"]
  node_dashboard["Dashboard"]
  node_expenses["Expenses"]
  node_finance["Finance"]
  node_reporting["Reports and analytics"]
end

subgraph group_platform["Platform administration"]
  node_people["Users and roles"]
  node_tenant["Tenant management"]
  node_billing["Billing and subscription"]
  node_ai["AI workspace"]
end

node_user(("Business user"))
node_api{{"BusinessOS API"}}

node_user -->|"opens"| node_routing
node_routing -->|"routes to"| node_auth
node_routing -->|"guards routes"| node_guards
node_routing -->|"routes to"| node_dashboard
node_routing -->|"routes to"| node_catalog
node_routing -->|"routes to"| node_inventory
node_routing -->|"routes to"| node_customers
node_routing -->|"routes to"| node_sales
node_routing -->|"routes to"| node_quotations
node_routing -->|"routes to"| node_purchasing
node_routing -->|"routes to"| node_invoices
node_routing -->|"routes to"| node_expenses
node_routing -->|"routes to"| node_finance
node_routing -->|"routes to"| node_reporting
node_routing -->|"routes to"| node_people
node_routing -->|"routes to"| node_tenant
node_routing -->|"routes to"| node_billing
node_routing -->|"routes to"| node_ai
node_catalog -->|"checks permissions"| node_guards
node_dashboard -.->|"loads dashboard data"| node_api

click node_routing "https://github.com/aliahsan9/businessos_ui/blob/main/src/app/app.routes.ts"
click node_auth "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/auth"
click node_guards "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/core/guards"
click node_dashboard "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/dashboard"
click node_catalog "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/products"
click node_inventory "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/inventory"
click node_customers "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/customers"
click node_sales "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/orders"
click node_quotations "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/quotations"
click node_purchasing "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/purchase-orders"
click node_invoices "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/invoices"
click node_expenses "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/expenses"
click node_finance "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/finance"
click node_reporting "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/reports"
click node_people "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/users"
click node_tenant "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/tenant"
click node_billing "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/billing"
click node_ai "https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/ai"

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_routing,node_auth,node_guards,node_user toneBlue
class node_catalog,node_inventory,node_customers,node_sales,node_quotations,node_purchasing,node_invoices toneAmber
class node_dashboard,node_expenses,node_finance,node_reporting,node_api toneMint
class node_people,node_tenant,node_billing,node_ai toneRose
```

## Components

### Entry and access

- [Application routing](https://github.com/aliahsan9/businessos_ui/blob/main/src/app/app.routes.ts): `src/app/app.routes.ts`
- [Authentication](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/auth): `src/app/features/auth`
- [Access guards](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/core/guards): `src/app/core/guards`

### Business operations

- [Products and categories](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/products): `src/app/features/products`
- [Inventory](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/inventory): `src/app/features/inventory`
- [Customers](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/customers): `src/app/features/customers`
- [Orders and sales](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/orders): `src/app/features/orders`
- [Quotations](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/quotations): `src/app/features/quotations`
- [Suppliers and purchasing](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/purchase-orders): `src/app/features/purchase-orders`
- [Invoices and payments](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/invoices): `src/app/features/invoices`

### Insights and finance

- [Dashboard](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/dashboard): `src/app/features/dashboard`
- [Expenses](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/expenses): `src/app/features/expenses`
- [Finance](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/finance): `src/app/features/finance`
- [Reports and analytics](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/reports): `src/app/features/reports`

### Platform administration

- [Users and roles](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/users): `src/app/features/users`
- [Tenant management](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/tenant): `src/app/features/tenant`
- [Billing and subscription](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/billing): `src/app/features/billing`
- [AI workspace](https://github.com/aliahsan9/businessos_ui/tree/main/src/app/features/ai): `src/app/features/ai`

### Other components

- **Business user**
- **BusinessOS API**

## Connections

- Business user → Application routing: opens (evidence: `src/app/app.routes.ts`)
- Application routing → Authentication: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Access guards: guards routes (evidence: `src/app/app.routes.ts`)
- Application routing → Dashboard: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Products and categories: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Inventory: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Customers: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Orders and sales: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Quotations: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Suppliers and purchasing: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Invoices and payments: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Expenses: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Finance: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Reports and analytics: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Users and roles: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Tenant management: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → Billing and subscription: routes to (evidence: `src/app/app.routes.ts`)
- Application routing → AI workspace: routes to (evidence: `src/app/app.routes.ts`)
- Products and categories → Access guards: checks permissions (evidence: `src/app/features/products/products.routes.ts`)
- Dashboard → BusinessOS API: loads dashboard data (evidence: `README.md`)
