# vladus-cpu/dbauc2 architecture

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

- Interactive diagram: https://gitdiagram.com/vladus-cpu/dbauc2
- Repository: https://github.com/vladus-cpu/dbauc2

## Overview

This is a web marketplace centered on double auctions: users browse listings, participate in auctions, and manage orders and wallet funds; administrators also manage auction activity. The backend exposes domain routes and runs scheduled clearing, while the browser UI uses API clients and session controls. Evidence is limited to the supplied excerpts and SOURCE INDEX; several product areas are visible only by filename, so their internal calls are not inferred.

Main entry points: [`frontend/js/ui/session.js`](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session.js) (Session access), [`backend/routes/aucmodel.py`](https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/aucmodel.py) (Auction routes), [`backend/db.py`](https://github.com/vladus-cpu/dbauc2/blob/main/backend/db.py) (Marketplace database), [`frontend/js/pages/listings.js`](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/listings.js) (Listings screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Browser experience"]
  node_auction_pages["Auction screens<br/>[auction-detail.js]"]
  node_listing_pages["Listings screens<br/>[listings.js]"]
  node_account_pages["Account screens<br/>[account.js]"]
  node_profile_pages["Profile screens<br/>[profile.js]"]
  node_admin_pages["Admin screens<br/>[admin.js]"]
  node_wallet_pages["Wallet screens<br/>[wallet.js]"]
  node_session["Session access<br/>[session.js]"]
  node_session_resolver["Session resolver<br/>[resolver.js]"]
  node_session_cache["Session cache<br/>[cache.js]"]
  node_session_normalize["Session normalization<br/>[normalize.js]"]
  node_session_visibility["Role visibility<br/>[visibility.js]"]
  node_toast["Notifications<br/>[toast.js]"]
end

subgraph group_api["Browser API"]
  node_api_http["HTTP transport<br/>[http.js]"]
  node_api_auth["Authentication client<br/>[auth.js]"]
  node_api_auctions["Auction client<br/>[auctions.js]"]
  node_api_listings["Listing client<br/>[listings.js]"]
  node_api_admin["Admin client<br/>[admin.js]"]
  node_api_other["Other API clients"]
end

subgraph group_domain["Marketplace backend"]
  node_backend_app["Flask application<br/>[app.py]"]
  node_auth_routes["Authentication routes<br/>[auth.py]"]
  node_auction_routes["Auction routes<br/>[aucmodel.py]"]
  node_listing_routes["Listing routes<br/>[listings.py]"]
  node_account_routes["Accounts and profiles<br/>[accounts.py]"]
  node_order_routes["Orders and resources<br/>[orders.py]"]
  node_wallet_routes["Wallet routes<br/>[wallet.py]"]
  node_admin_routes["Administration routes<br/>[admin.py]"]
  node_security["Authentication security<br/>[security.py]"]
  node_db[("Marketplace database<br/>[db.py]")]
end

subgraph group_runtime["Auction runtime"]
  node_auction_service["Clearing algorithms<br/>[auction.py]"]
  node_scheduler["Scheduled clearing"]
  node_wallet_service["Wallet ledger<br/>[wallet.py]"]
  node_auction_helpers["Auction helpers<br/>[aucservices.py]"]
end

node_trader(("Trader"))
node_admin_actor(("Administrator"))

node_trader -.->|"uses"| node_auction_pages
node_trader -.->|"browses"| node_listing_pages
node_trader -.->|"manages account"| node_account_pages
node_admin_actor -.->|"manages"| node_admin_pages
node_auction_pages -->|"checks access"| node_session
node_auction_pages -->|"shows notices"| node_toast
node_auction_pages -.->|"requests auction data"| node_api_auctions
node_listing_pages -->|"checks access"| node_session
node_listing_pages -->|"shows notices"| node_toast
node_listing_pages -.->|"requests listings"| node_api_listings
node_listing_pages -->|"requests admin data"| node_api_admin
node_account_pages -->|"checks access"| node_session
node_account_pages -->|"shows notices"| node_toast
node_profile_pages -->|"checks access"| node_session
node_profile_pages -->|"shows notices"| node_toast
node_admin_pages -->|"checks access"| node_session
node_admin_pages -->|"shows notices"| node_toast
node_admin_pages -->|"requests auctions"| node_api_auctions
node_wallet_pages -.->|"uses wallet client"| node_api_other
node_session -->|"resolves session"| node_session_resolver
node_session -->|"reads cache"| node_session_cache
node_session -->|"creates guest"| node_session_normalize
node_session -->|"sets visibility"| node_session_visibility
node_session_resolver -->|"fetches identity"| node_api_auth
node_session_resolver -->|"uses cache"| node_session_cache
node_session_resolver -->|"normalizes identity"| node_session_normalize
node_api_auth -->|"uses transport"| node_api_http
node_api_auctions -->|"uses transport"| node_api_http
node_api_listings -->|"uses transport"| node_api_http
node_api_admin -->|"uses transport"| node_api_http
node_api_http -->|"reads token"| node_api_auth
node_backend_app -->|"initializes schema"| node_db
node_backend_app -->|"starts scheduler"| node_scheduler
node_backend_app -.->|"routes requests"| node_auth_routes
node_auction_routes -->|"reads and writes"| node_db
node_auction_routes -->|"checks access"| node_security
node_auction_routes -->|"computes clearing"| node_auction_service
node_auction_routes -->|"updates balances"| node_wallet_service
node_auction_routes -->|"uses helpers"| node_auction_helpers
node_listing_routes -->|"reads and writes"| node_db
node_listing_routes -->|"checks access"| node_security
node_auth_routes -->|"reads and writes"| node_db
node_auth_routes -->|"uses tokens"| node_security
node_wallet_routes -->|"reads and writes"| node_db
node_wallet_routes -->|"performs transactions"| node_wallet_service
node_wallet_routes -->|"checks access"| node_security
node_admin_routes -->|"reads and writes"| node_db
node_admin_routes -->|"checks access"| node_security

click node_auction_pages "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/auction-detail.js"
click node_listing_pages "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/listings.js"
click node_account_pages "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/account.js"
click node_profile_pages "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/profile.js"
click node_admin_pages "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/admin.js"
click node_wallet_pages "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/wallet.js"
click node_session "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session.js"
click node_session_resolver "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session/resolver.js"
click node_session_cache "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session/cache.js"
click node_session_normalize "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session/normalize.js"
click node_session_visibility "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session/visibility.js"
click node_toast "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/toast.js"
click node_api_http "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/api/http.js"
click node_api_auth "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/api/auth.js"
click node_api_auctions "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/api/auctions.js"
click node_api_listings "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/api/listings.js"
click node_api_admin "https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/api/admin.js"
click node_api_other "https://github.com/vladus-cpu/dbauc2/tree/main/frontend/js/api"
click node_backend_app "https://github.com/vladus-cpu/dbauc2/blob/main/backend/app.py"
click node_auth_routes "https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/auth.py"
click node_auction_routes "https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/aucmodel.py"
click node_listing_routes "https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/listings.py"
click node_account_routes "https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/accounts.py"
click node_order_routes "https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/orders.py"
click node_wallet_routes "https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/wallet.py"
click node_admin_routes "https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/admin.py"
click node_security "https://github.com/vladus-cpu/dbauc2/blob/main/backend/security.py"
click node_db "https://github.com/vladus-cpu/dbauc2/blob/main/backend/db.py"
click node_auction_service "https://github.com/vladus-cpu/dbauc2/blob/main/backend/services/auction.py"
click node_scheduler "https://github.com/vladus-cpu/dbauc2/blob/main/backend/services/clearing_scheduler.py"
click node_wallet_service "https://github.com/vladus-cpu/dbauc2/blob/main/backend/services/wallet.py"
click node_auction_helpers "https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/aucservices.py"

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_auction_pages,node_listing_pages,node_account_pages,node_profile_pages,node_admin_pages,node_wallet_pages,node_session,node_session_resolver,node_session_cache,node_session_normalize,node_session_visibility,node_toast toneBlue
class node_api_http,node_api_auth,node_api_auctions,node_api_listings,node_api_admin,node_api_other toneAmber
class node_backend_app,node_auth_routes,node_auction_routes,node_listing_routes,node_account_routes,node_order_routes,node_wallet_routes,node_admin_routes,node_security,node_db toneMint
class node_auction_service,node_scheduler,node_wallet_service,node_auction_helpers toneRose
class node_trader,node_admin_actor toneIndigo
```

## Components

### Browser experience

- [Auction screens](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/auction-detail.js): `frontend/js/pages/auction-detail.js`
- [Listings screens](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/listings.js): `frontend/js/pages/listings.js`
- [Account screens](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/account.js): `frontend/js/pages/account.js`
- [Profile screens](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/profile.js): `frontend/js/pages/profile.js`
- [Admin screens](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/admin.js): `frontend/js/pages/admin.js`
- [Wallet screens](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/pages/wallet.js): `frontend/js/pages/wallet.js`
- [Session access](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session.js): `frontend/js/ui/session.js`
- [Session resolver](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session/resolver.js): `frontend/js/ui/session/resolver.js`
- [Session cache](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session/cache.js): `frontend/js/ui/session/cache.js`
- [Session normalization](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session/normalize.js): `frontend/js/ui/session/normalize.js`
- [Role visibility](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/session/visibility.js): `frontend/js/ui/session/visibility.js`
- [Notifications](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/ui/toast.js): `frontend/js/ui/toast.js`

### Browser API

- [HTTP transport](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/api/http.js): `frontend/js/api/http.js`
- [Authentication client](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/api/auth.js): `frontend/js/api/auth.js`
- [Auction client](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/api/auctions.js): `frontend/js/api/auctions.js`
- [Listing client](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/api/listings.js): `frontend/js/api/listings.js`
- [Admin client](https://github.com/vladus-cpu/dbauc2/blob/main/frontend/js/api/admin.js): `frontend/js/api/admin.js`
- [Other API clients](https://github.com/vladus-cpu/dbauc2/tree/main/frontend/js/api): `frontend/js/api`

### Marketplace backend

- [Flask application](https://github.com/vladus-cpu/dbauc2/blob/main/backend/app.py): `backend/app.py`
- [Authentication routes](https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/auth.py): `backend/routes/auth.py`
- [Auction routes](https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/aucmodel.py): `backend/routes/aucmodel.py`
- [Listing routes](https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/listings.py): `backend/routes/listings.py`
- [Accounts and profiles](https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/accounts.py): `backend/routes/accounts.py`
- [Orders and resources](https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/orders.py): `backend/routes/orders.py`
- [Wallet routes](https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/wallet.py): `backend/routes/wallet.py`
- [Administration routes](https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/admin.py): `backend/routes/admin.py`
- [Authentication security](https://github.com/vladus-cpu/dbauc2/blob/main/backend/security.py): `backend/security.py`
- [Marketplace database](https://github.com/vladus-cpu/dbauc2/blob/main/backend/db.py): `backend/db.py`

### Auction runtime

- [Clearing algorithms](https://github.com/vladus-cpu/dbauc2/blob/main/backend/services/auction.py): `backend/services/auction.py`
- [Scheduled clearing](https://github.com/vladus-cpu/dbauc2/blob/main/backend/services/clearing_scheduler.py): `backend/services/clearing_scheduler.py`
- [Wallet ledger](https://github.com/vladus-cpu/dbauc2/blob/main/backend/services/wallet.py): `backend/services/wallet.py`
- [Auction helpers](https://github.com/vladus-cpu/dbauc2/blob/main/backend/routes/aucservices.py): `backend/routes/aucservices.py`

### Other components

- **Trader**
- **Administrator**

## Connections

- Trader → Auction screens: uses
- Trader → Listings screens: browses
- Trader → Account screens: manages account
- Administrator → Admin screens: manages
- Auction screens → Session access: checks access (evidence: `frontend/js/pages/auction-detail.js`)
- Auction screens → Notifications: shows notices (evidence: `frontend/js/pages/auction-detail.js`)
- Auction screens → Auction client: requests auction data
- Listings screens → Session access: checks access (evidence: `frontend/js/pages/listings.js`)
- Listings screens → Notifications: shows notices (evidence: `frontend/js/pages/listings.js`)
- Listings screens → Listing client: requests listings
- Listings screens → Admin client: requests admin data (evidence: `frontend/js/pages/listings.js`)
- Account screens → Session access: checks access (evidence: `frontend/js/pages/account.js`)
- Account screens → Notifications: shows notices (evidence: `frontend/js/pages/account.js`)
- Profile screens → Session access: checks access (evidence: `frontend/js/pages/profile.js`)
- Profile screens → Notifications: shows notices (evidence: `frontend/js/pages/profile.js`)
- Admin screens → Session access: checks access (evidence: `frontend/js/pages/admin.js`)
- Admin screens → Notifications: shows notices (evidence: `frontend/js/pages/admin.js`)
- Admin screens → Auction client: requests auctions (evidence: `frontend/js/pages/admin.js`)
- Wallet screens → Other API clients: uses wallet client
- Session access → Session resolver: resolves session (evidence: `frontend/js/ui/session.js`)
- Session access → Session cache: reads cache (evidence: `frontend/js/ui/session.js`)
- Session access → Session normalization: creates guest (evidence: `frontend/js/ui/session.js`)
- Session access → Role visibility: sets visibility (evidence: `frontend/js/ui/session.js`)
- Session resolver → Authentication client: fetches identity (evidence: `frontend/js/ui/session/resolver.js`)
- Session resolver → Session cache: uses cache (evidence: `frontend/js/ui/session/resolver.js`)
- Session resolver → Session normalization: normalizes identity (evidence: `frontend/js/ui/session/resolver.js`)
- Authentication client → HTTP transport: uses transport (evidence: `frontend/js/api/auth.js`)
- Auction client → HTTP transport: uses transport (evidence: `frontend/js/api/auctions.js`)
- Listing client → HTTP transport: uses transport (evidence: `frontend/js/api/listings.js`)
- Admin client → HTTP transport: uses transport (evidence: `frontend/js/api/admin.js`)
- HTTP transport → Authentication client: reads token (evidence: `frontend/js/api/http.js`)
- Flask application → Marketplace database: initializes schema (evidence: `backend/app.py`)
- Flask application → Scheduled clearing: starts scheduler (evidence: `backend/app.py`)
- Flask application → Authentication routes: routes requests
- Auction routes → Marketplace database: reads and writes (evidence: `backend/routes/aucmodel.py`)
- Auction routes → Authentication security: checks access (evidence: `backend/routes/aucmodel.py`)
- Auction routes → Clearing algorithms: computes clearing (evidence: `backend/routes/aucmodel.py`)
- Auction routes → Wallet ledger: updates balances (evidence: `backend/routes/aucmodel.py`)
- Auction routes → Auction helpers: uses helpers (evidence: `backend/routes/aucmodel.py`)
- Listing routes → Marketplace database: reads and writes (evidence: `backend/routes/listings.py`)
- Listing routes → Authentication security: checks access (evidence: `backend/routes/listings.py`)
- Authentication routes → Marketplace database: reads and writes (evidence: `backend/routes/auth.py`)
- Authentication routes → Authentication security: uses tokens (evidence: `backend/routes/auth.py`)
- Wallet routes → Marketplace database: reads and writes (evidence: `backend/routes/wallet.py`)
- Wallet routes → Wallet ledger: performs transactions (evidence: `backend/routes/wallet.py`)
- Wallet routes → Authentication security: checks access (evidence: `backend/routes/wallet.py`)
- Administration routes → Marketplace database: reads and writes (evidence: `backend/routes/admin.py`)
- Administration routes → Authentication security: checks access (evidence: `backend/routes/admin.py`)
