# d3nkyt0/pdlpro architecture

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

- Interactive diagram: https://gitdiagram.com/d3nkyt0/pdlpro
- Repository: https://github.com/d3nkyt0/pdlpro

## Overview

PDL PRO is a Lineage 2 community panel with public pages, a player area, and staff tools. The principal user path is entering through the React routes, accessing backend capabilities through the versioned API, and using account, server/character, economy, community, or reward features; staff also administers and reports on the service. The README establishes the product areas and separated frontend/backend, while sampled files show route registration, API transport, and selected module behavior. Many backend cross-module calls were not sampled, so uncertain links are omitted.

Main entry points: [`frontend/src/services/api.ts`](https://github.com/d3nkyt0/pdlpro/blob/master/frontend/src/services/api.ts) (Domain API facade), [`frontend/src/app/routes/AppRoutes.tsx`](https://github.com/d3nkyt0/pdlpro/blob/master/frontend/src/app/routes/AppRoutes.tsx) (Application routes), [`frontend/src/services/infra/http.ts`](https://github.com/d3nkyt0/pdlpro/blob/master/frontend/src/services/infra/http.ts) (API client), [`backend/apps/accounts/presentation/views/auth.py`](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/accounts/presentation/views/auth.py) (Accounts and access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_routes["Application routes<br/>[AppRoutes.tsx]"]
  node_client_api["API client<br/>[http.ts]"]
  node_api_facade["Domain API facade<br/>[api.ts]"]
end

subgraph group_identity["Accounts and server"]
  node_accounts["Accounts and access<br/>[auth.py]"]
  node_server["Server and characters<br/>[customer.py]"]
  node_inventory["Inventory<br/>[customer.py]"]
  node_account_repositories["Account repository ports<br/>[repositories.py]"]
end

subgraph group_commerce["Economy and rewards"]
  node_wallet_payment["Wallet and payments<br/>[use_cases.py]"]
  node_shop["Shop and packages"]
  node_marketplace["Marketplace<br/>[use_cases.py]"]
  node_auction["Auctions<br/>[use_cases.py]"]
  node_games["Rewards and games<br/>[use_cases.py]"]
end

subgraph group_community["Community and content"]
  node_content["Community content<br/>[use_cases.py]"]
  node_communication["Notifications and push<br/>[use_cases.py]"]
  node_support["Player support<br/>[use_cases.py]"]
end

subgraph group_operations["Staff and appearance"]
  node_staff["Staff operations"]
  node_themes["Themes and appearance<br/>[theme_packages.py]"]
end

node_player(("Players and staff"))

node_player -->|"opens panel"| node_routes
node_routes -.->|"uses API"| node_client_api
node_client_api -.->|"serves requests"| node_api_facade
node_api_facade -.->|"requests account features"| node_accounts
node_api_facade -.->|"requests server data"| node_server
node_api_facade -.->|"requests inventory"| node_inventory
node_api_facade -.->|"requests payments"| node_wallet_payment
node_api_facade -.->|"requests commerce"| node_shop
node_api_facade -.->|"requests listings"| node_marketplace
node_api_facade -.->|"requests auctions"| node_auction
node_api_facade -.->|"requests rewards"| node_games
node_api_facade -.->|"requests content"| node_content
node_api_facade -.->|"requests notifications"| node_communication
node_api_facade -.->|"requests support"| node_support
node_api_facade -.->|"requests staff tools"| node_staff
node_api_facade -.->|"requests themes"| node_themes
node_accounts -.->|"uses ports"| node_account_repositories

click node_routes "https://github.com/d3nkyt0/pdlpro/blob/master/frontend/src/app/routes/AppRoutes.tsx"
click node_client_api "https://github.com/d3nkyt0/pdlpro/blob/master/frontend/src/services/infra/http.ts"
click node_api_facade "https://github.com/d3nkyt0/pdlpro/blob/master/frontend/src/services/api.ts"
click node_accounts "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/accounts/presentation/views/auth.py"
click node_server "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/server/presentation/views/customer.py"
click node_inventory "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/inventory/presentation/views/customer.py"
click node_wallet_payment "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/payment/application/use_cases.py"
click node_shop "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/shop/application/commerce_use_cases.py"
click node_marketplace "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/marketplace/application/use_cases.py"
click node_auction "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/auction/application/use_cases.py"
click node_games "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/games/application/use_cases.py"
click node_content "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/content/application/use_cases.py"
click node_communication "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/communication/application/use_cases.py"
click node_support "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/support/application/use_cases.py"
click node_staff "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/staff/presentation/views/operational_reports.py"
click node_themes "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/themes/application/theme_packages.py"
click node_account_repositories "https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/accounts/domain/repositories.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_routes,node_client_api,node_api_facade toneBlue
class node_accounts,node_server,node_inventory,node_account_repositories toneAmber
class node_wallet_payment,node_shop,node_marketplace,node_auction,node_games toneMint
class node_content,node_communication,node_support toneRose
class node_staff,node_themes,node_player toneIndigo
```

## Components

### User experience

- [Application routes](https://github.com/d3nkyt0/pdlpro/blob/master/frontend/src/app/routes/AppRoutes.tsx): `frontend/src/app/routes/AppRoutes.tsx`
- [API client](https://github.com/d3nkyt0/pdlpro/blob/master/frontend/src/services/infra/http.ts): `frontend/src/services/infra/http.ts`
- [Domain API facade](https://github.com/d3nkyt0/pdlpro/blob/master/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Accounts and server

- [Accounts and access](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/accounts/presentation/views/auth.py): `backend/apps/accounts/presentation/views/auth.py`
- [Server and characters](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/server/presentation/views/customer.py): `backend/apps/server/presentation/views/customer.py`
- [Inventory](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/inventory/presentation/views/customer.py): `backend/apps/inventory/presentation/views/customer.py`
- [Account repository ports](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/accounts/domain/repositories.py): `backend/apps/accounts/domain/repositories.py`

### Economy and rewards

- [Wallet and payments](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/payment/application/use_cases.py): `backend/apps/payment/application/use_cases.py`
- [Shop and packages](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/shop/application/commerce_use_cases.py): `backend/apps/shop/application/commerce_use_cases.py`
- [Marketplace](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/marketplace/application/use_cases.py): `backend/apps/marketplace/application/use_cases.py`
- [Auctions](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/auction/application/use_cases.py): `backend/apps/auction/application/use_cases.py`
- [Rewards and games](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/games/application/use_cases.py): `backend/apps/games/application/use_cases.py`

### Community and content

- [Community content](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/content/application/use_cases.py): `backend/apps/content/application/use_cases.py`
- [Notifications and push](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/communication/application/use_cases.py): `backend/apps/communication/application/use_cases.py`
- [Player support](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/support/application/use_cases.py): `backend/apps/support/application/use_cases.py`

### Staff and appearance

- [Staff operations](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/staff/presentation/views/operational_reports.py): `backend/apps/staff/presentation/views/operational_reports.py`
- [Themes and appearance](https://github.com/d3nkyt0/pdlpro/blob/master/backend/apps/themes/application/theme_packages.py): `backend/apps/themes/application/theme_packages.py`

### Other components

- **Players and staff**

## Connections

- Players and staff → Application routes: opens panel (evidence: `README.md`)
- Application routes → API client: uses API
- API client → Domain API facade: serves requests (evidence: `frontend/src/services/api.ts`)
- Domain API facade → Accounts and access: requests account features
- Domain API facade → Server and characters: requests server data
- Domain API facade → Inventory: requests inventory
- Domain API facade → Wallet and payments: requests payments
- Domain API facade → Shop and packages: requests commerce
- Domain API facade → Marketplace: requests listings
- Domain API facade → Auctions: requests auctions
- Domain API facade → Rewards and games: requests rewards
- Domain API facade → Community content: requests content
- Domain API facade → Notifications and push: requests notifications
- Domain API facade → Player support: requests support
- Domain API facade → Staff operations: requests staff tools
- Domain API facade → Themes and appearance: requests themes
- Accounts and access → Account repository ports: uses ports
