# olegkapaev/lynx-studio-stds architecture

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

- Interactive diagram: https://gitdiagram.com/olegkapaev/lynx-studio-stds
- Repository: https://github.com/olegkapaev/lynx-studio-stds

## Overview

The product is a Russian-language storefront for translated DVS 2205 printed standards, with customer ordering, legal information, outbound email, and an internal sales-admin panel. The documented customer journey is to browse the catalog and place an order; staff then manage order records through the admin interface. The tree and excerpts chiefly expose admin runtime code, so public-site stages and email capabilities are represented from the README rather than inferred implementation details. The SQLite connection is explicit in auth.php; handler-level database operations were not sampled.

Main entry points: [`src/server/admin/components/js/admin.js`](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/admin.js) (Admin UI dispatcher), [`src/server/admin/components/js/core/api.js`](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/api.js) (Admin API client), [`src/server/admin/components/js/core/ui.js`](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/ui.js) (Modal and table UI), [`src/server/admin/components/js/modules/mod-form-injector.js`](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-injector.js) (Edit-form population)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_catalog["Standards catalog"]
  node_legal["Legal information"]
  node_orderform["Order forms"]
end

subgraph group_orders["Order management"]
  node_addhandler["Create order handler<br/>[salesRowAdd.php]"]
  node_savehandler["Save order handler<br/>[salesRowsSave.php]"]
  node_deletehandler["Delete orders handler"]
  node_importhandler["Import orders handler"]
  node_updatehandler["Refresh orders handler"]
  node_cityhandler["Address lookup proxy<br/>[apiDaDataProxy.php]"]
  node_database[("Sales database")]
end

subgraph group_admin["Admin interface"]
  node_login["Admin login<br/>[login.php]"]
  node_auth["Session and access<br/>[auth.php]"]
  node_dispatcher["Admin UI dispatcher<br/>[admin.js]"]
  node_coreapi["Admin API client<br/>[api.js]"]
  node_dom["DOM access<br/>[dom.js]"]
  node_events["Event hub<br/>[events.js]"]
  node_state["Admin state<br/>[state.js]"]
  node_ui["Modal and table UI<br/>[ui.js]"]
  node_forms["Form workflows<br/>[mod-form-submit.js]"]
  node_validation["Form validation"]
  node_autocomplete["City autocomplete"]
  node_injector["Edit-form population"]
  node_navigation["Record navigation"]
  node_tracking["Change tracking"]
  node_clear["Form clearing<br/>[mod-form-clear.js]"]
  node_rows["Table row controls<br/>[mod-table-rows.js]"]
  node_deletion["Record deletion"]
  node_import["CSV import"]
  node_export["CSV export"]
end

subgraph group_communications["Communications"]
  node_email["Outbound email<br/>[outreach.php]"]
  node_emailtemplates["Email templates<br/>[templatesAdmin.php]"]
end

node_visitor(("Customer"))
node_adminuser(("Admin staff"))

node_visitor -->|"browses"| node_catalog
node_catalog -->|"leads to"| node_orderform
node_visitor -->|"consults"| node_legal
node_visitor -->|"submits order"| node_orderform
node_adminuser -->|"signs in"| node_login
node_login -->|"checks session"| node_auth
node_dispatcher -->|"imports"| node_coreapi
node_dispatcher -->|"imports"| node_dom
node_dispatcher -->|"initializes"| node_events
node_dispatcher -->|"initializes"| node_ui
node_dispatcher -->|"registers"| node_forms
node_dispatcher -->|"registers"| node_validation
node_dispatcher -->|"registers"| node_autocomplete
node_dispatcher -->|"registers"| node_deletion
node_dispatcher -->|"registers"| node_export
node_dispatcher -->|"registers"| node_import
node_dispatcher -->|"uses for edits"| node_injector
node_dispatcher -->|"registers"| node_tracking
node_dispatcher -->|"registers"| node_navigation
node_dispatcher -->|"initializes"| node_clear
node_state -->|"emits changes"| node_events
node_ui -->|"uses selectors"| node_dom
node_ui -->|"loads edit data"| node_injector
node_injector -->|"updates active row"| node_state
node_injector -->|"opens modal"| node_ui
node_rows -->|"saves flags"| node_coreapi
node_deletion -->|"requests deletion"| node_coreapi
node_deletion -->|"renders refreshed rows"| node_ui
node_deletion -->|"loads neighbor record"| node_injector
node_coreapi -->|"posts deletion"| node_deletehandler
node_coreapi -->|"posts order changes"| node_savehandler
node_coreapi -->|"posts new order"| node_addhandler
node_coreapi -->|"requests refresh"| node_updatehandler
node_coreapi -->|"requests suggestions"| node_cityhandler
node_import -->|"uses transport"| node_coreapi
node_importhandler -->|"loads access core"| node_auth
node_auth -->|"opens SQLite"| node_database
node_adminuser -->|"runs campaigns"| node_email
node_email -.->|"uses templates"| node_emailtemplates

click node_catalog "https://github.com/olegkapaev/lynx-studio-stds/tree/main/src/pages"
click node_legal "https://github.com/olegkapaev/lynx-studio-stds/tree/main/src/assets/md"
click node_orderform "https://github.com/olegkapaev/lynx-studio-stds/tree/main/src/pages"
click node_login "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/login.php"
click node_auth "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/core/auth.php"
click node_dispatcher "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/admin.js"
click node_coreapi "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/api.js"
click node_dom "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/dom.js"
click node_events "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/events.js"
click node_state "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/state.js"
click node_ui "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/ui.js"
click node_forms "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-submit.js"
click node_validation "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-validation.js"
click node_autocomplete "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-autocomplete.js"
click node_injector "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-injector.js"
click node_navigation "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-navigation.js"
click node_tracking "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-tracking.js"
click node_clear "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-clear.js"
click node_rows "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-table-rows.js"
click node_deletion "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-table-delete.js"
click node_import "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-table-import.js"
click node_export "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-table-export.js"
click node_addhandler "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/salesRowAdd.php"
click node_savehandler "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/salesRowsSave.php"
click node_deletehandler "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/salesRowsDelete.php"
click node_importhandler "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/salesRowsImport.php"
click node_updatehandler "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/salesRowsUpdate.php"
click node_cityhandler "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/apiDaDataProxy.php"
click node_database "https://github.com/olegkapaev/lynx-studio-stds/tree/main/database"
click node_email "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/emails/outreach.php"
click node_emailtemplates "https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/emails/templatesAdmin.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_catalog,node_legal,node_orderform toneBlue
class node_addhandler,node_savehandler,node_deletehandler,node_importhandler,node_updatehandler,node_cityhandler,node_database toneAmber
class node_login,node_auth,node_dispatcher,node_coreapi,node_dom,node_events,node_state,node_ui,node_forms,node_validation,node_autocomplete,node_injector,node_navigation,node_tracking,node_clear,node_rows,node_deletion,node_import,node_export toneMint
class node_email,node_emailtemplates toneRose
class node_visitor,node_adminuser toneIndigo
```

## Components

### Storefront

- [Standards catalog](https://github.com/olegkapaev/lynx-studio-stds/tree/main/src/pages): `src/pages`
- [Legal information](https://github.com/olegkapaev/lynx-studio-stds/tree/main/src/assets/md): `src/assets/md`
- [Order forms](https://github.com/olegkapaev/lynx-studio-stds/tree/main/src/pages): `src/pages`

### Order management

- [Create order handler](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/salesRowAdd.php): `src/server/admin/handlers/salesRowAdd.php`
- [Save order handler](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/salesRowsSave.php): `src/server/admin/handlers/salesRowsSave.php`
- [Delete orders handler](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/salesRowsDelete.php): `src/server/admin/handlers/salesRowsDelete.php`
- [Import orders handler](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/salesRowsImport.php): `src/server/admin/handlers/salesRowsImport.php`
- [Refresh orders handler](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/salesRowsUpdate.php): `src/server/admin/handlers/salesRowsUpdate.php`
- [Address lookup proxy](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/handlers/apiDaDataProxy.php): `src/server/admin/handlers/apiDaDataProxy.php`
- [Sales database](https://github.com/olegkapaev/lynx-studio-stds/tree/main/database): `database`

### Admin interface

- [Admin login](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/login.php): `src/server/admin/login.php`
- [Session and access](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/core/auth.php): `src/server/core/auth.php`
- [Admin UI dispatcher](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/admin.js): `src/server/admin/components/js/admin.js`
- [Admin API client](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/api.js): `src/server/admin/components/js/core/api.js`
- [DOM access](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/dom.js): `src/server/admin/components/js/core/dom.js`
- [Event hub](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/events.js): `src/server/admin/components/js/core/events.js`
- [Admin state](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/state.js): `src/server/admin/components/js/core/state.js`
- [Modal and table UI](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/core/ui.js): `src/server/admin/components/js/core/ui.js`
- [Form workflows](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-submit.js): `src/server/admin/components/js/modules/mod-form-submit.js`
- [Form validation](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-validation.js): `src/server/admin/components/js/modules/mod-form-validation.js`
- [City autocomplete](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-autocomplete.js): `src/server/admin/components/js/modules/mod-form-autocomplete.js`
- [Edit-form population](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-injector.js): `src/server/admin/components/js/modules/mod-form-injector.js`
- [Record navigation](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-navigation.js): `src/server/admin/components/js/modules/mod-form-navigation.js`
- [Change tracking](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-tracking.js): `src/server/admin/components/js/modules/mod-form-tracking.js`
- [Form clearing](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-form-clear.js): `src/server/admin/components/js/modules/mod-form-clear.js`
- [Table row controls](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-table-rows.js): `src/server/admin/components/js/modules/mod-table-rows.js`
- [Record deletion](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-table-delete.js): `src/server/admin/components/js/modules/mod-table-delete.js`
- [CSV import](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-table-import.js): `src/server/admin/components/js/modules/mod-table-import.js`
- [CSV export](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/admin/components/js/modules/mod-table-export.js): `src/server/admin/components/js/modules/mod-table-export.js`

### Communications

- [Outbound email](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/emails/outreach.php): `src/server/emails/outreach.php`
- [Email templates](https://github.com/olegkapaev/lynx-studio-stds/blob/main/src/server/emails/templatesAdmin.php): `src/server/emails/templatesAdmin.php`

### Other components

- **Customer**
- **Admin staff**

## Connections

- Customer → Standards catalog: browses
- Standards catalog → Order forms: leads to
- Customer → Legal information: consults
- Customer → Order forms: submits order
- Admin staff → Admin login: signs in
- Admin login → Session and access: checks session (evidence: `src/server/admin/login.php`)
- Admin UI dispatcher → Admin API client: imports (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → DOM access: imports (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → Event hub: initializes (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → Modal and table UI: initializes (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → Form workflows: registers (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → Form validation: registers (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → City autocomplete: registers (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → Record deletion: registers (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → CSV export: registers (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → CSV import: registers (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → Edit-form population: uses for edits (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → Change tracking: registers (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → Record navigation: registers (evidence: `src/server/admin/components/js/admin.js`)
- Admin UI dispatcher → Form clearing: initializes (evidence: `src/server/admin/components/js/admin.js`)
- Admin state → Event hub: emits changes (evidence: `src/server/admin/components/js/core/state.js`)
- Modal and table UI → DOM access: uses selectors (evidence: `src/server/admin/components/js/core/ui.js`)
- Modal and table UI → Edit-form population: loads edit data (evidence: `src/server/admin/components/js/core/ui.js`)
- Edit-form population → Admin state: updates active row (evidence: `src/server/admin/components/js/modules/mod-form-injector.js`)
- Edit-form population → Modal and table UI: opens modal (evidence: `src/server/admin/components/js/modules/mod-form-injector.js`)
- Table row controls → Admin API client: saves flags (evidence: `src/server/admin/components/js/modules/mod-table-rows.js`)
- Record deletion → Admin API client: requests deletion (evidence: `src/server/admin/components/js/modules/mod-table-delete.js`)
- Record deletion → Modal and table UI: renders refreshed rows (evidence: `src/server/admin/components/js/modules/mod-table-delete.js`)
- Record deletion → Edit-form population: loads neighbor record (evidence: `src/server/admin/components/js/modules/mod-table-delete.js`)
- Admin API client → Delete orders handler: posts deletion (evidence: `src/server/admin/components/js/core/api.js`)
- Admin API client → Save order handler: posts order changes (evidence: `src/server/admin/components/js/core/api.js`)
- Admin API client → Create order handler: posts new order (evidence: `src/server/admin/components/js/core/api.js`)
- Admin API client → Refresh orders handler: requests refresh (evidence: `src/server/admin/components/js/core/api.js`)
- Admin API client → Address lookup proxy: requests suggestions (evidence: `src/server/admin/components/js/core/api.js`)
- CSV import → Admin API client: uses transport (evidence: `src/server/admin/components/js/modules/mod-table-import.js`)
- Import orders handler → Session and access: loads access core (evidence: `src/server/admin/handlers/salesRowsImport.php`)
- Session and access → Sales database: opens SQLite (evidence: `src/server/core/auth.php`)
- Admin staff → Outbound email: runs campaigns
- Outbound email → Email templates: uses templates
