# hengtongan/jakarta-project architecture

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

- Interactive diagram: https://gitdiagram.com/hengtongan/jakarta-project
- Repository: https://github.com/hengtongan/jakarta-project

## Overview

This is a server-rendered Jakarta EE computer-hardware storefront with a separate administration area. Customers browse products, manage a cart, check out through card or ABA Payway, and review orders; admins manage catalogue, stock, orders, users, reviews, payments, reports, support mail, and audit history. The map includes the documented security, live-update, and operations capabilities. Source excerpts and index references establish only some internal calls, so unsampled workflow links are shown as unverified rather than asserted.

Main entry points: [`computerstore/src/main/java/com/hengtongan/computerstore/core/service/ReviewService.java`](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/ReviewService.java) (Customer reviews), [`computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/CheckoutServlet.java`](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/CheckoutServlet.java) (Checkout), [`computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/ProductServlet.java`](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/ProductServlet.java) (Storefront), [`computerstore/src/main/java/com/hengtongan/computerstore/core/service/ProductService.java`](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/ProductService.java) (Product catalogue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry points"]
  node_storefront["Storefront"]
  node_auth["Account access<br/>[AuthService.java]"]
  node_checkout["Checkout"]
  node_orders["Order history"]
  node_filters["Request filters"]
end

subgraph group_commerce["Storefront commerce"]
  node_cart["Cart<br/>[CartService.java]"]
  node_catalog["Product catalogue"]
  node_reviews["Customer reviews<br/>[ReviewService.java]"]
  node_payment["Payment processing"]
  node_product_repo["Product persistence"]
  node_review_repo["Review persistence"]
  node_user_repo["User persistence"]
end

subgraph group_admin["Administration"]
  node_admin_catalog["Catalogue and stock"]
  node_admin_orders["Order management"]
  node_admin_reviews["Review moderation"]
  node_admin_ops["Admin operations"]
  node_admin_support["Support mailbox"]
  node_admin_users["User management"]
end

subgraph group_platform["Platform services"]
  node_aba["ABA Payway"]
  node_realtime["Live events<br/>[EventHub.java]"]
  node_experience["Experience monitoring"]
  node_metrics["Metrics and health"]
  node_cache["Application cache<br/>[CacheManager.java]"]
  node_database[("Store database<br/>[DBConnection.java]")]
end

node_customer(("Customer"))
node_operator(("Store admin"))

node_customer -->|"browses"| node_storefront
node_customer -->|"manages account"| node_auth
node_customer -->|"checks out"| node_checkout
node_customer -->|"views orders"| node_orders
node_operator -->|"manages catalogue"| node_admin_catalog
node_operator -->|"manages orders"| node_admin_orders
node_operator -->|"moderates"| node_admin_reviews
node_operator -->|"reviews reports"| node_admin_ops
node_operator -->|"handles mail"| node_admin_support
node_operator -->|"manages users"| node_admin_users
node_storefront -.->|"loads products"| node_catalog
node_storefront -.->|"shows reviews"| node_reviews
node_checkout -.->|"uses cart"| node_cart
node_checkout -.->|"starts payment"| node_payment
node_checkout -.->|"creates order"| node_orders
node_payment -->|"requests gateway"| node_aba
node_admin_reviews -->|"moderates via"| node_reviews
node_reviews -->|"reads and writes"| node_review_repo
node_reviews -->|"checks product"| node_catalog
node_reviews -->|"publishes count"| node_realtime
node_auth -->|"reads and creates"| node_user_repo
node_catalog -.->|"loads products"| node_product_repo
node_product_repo -.->|"queries"| node_database
node_review_repo -->|"queries"| node_database
node_user_repo -.->|"queries"| node_database
node_catalog -.->|"uses cache"| node_cache
node_reviews -->|"invalidates"| node_cache
node_filters -.->|"guards requests"| node_storefront
node_filters -.->|"guards requests"| node_checkout
node_experience -.->|"records experience"| node_metrics
node_cache -->|"records misses"| node_metrics
node_customer -.->|"reports experience"| node_experience
node_admin_catalog -.->|"manages products"| node_product_repo
node_admin_orders -.->|"manages status"| node_orders

click node_storefront "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/ProductServlet.java"
click node_auth "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/AuthService.java"
click node_checkout "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/CheckoutServlet.java"
click node_orders "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/CustomerOrdersServlet.java"
click node_cart "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/CartService.java"
click node_catalog "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/ProductService.java"
click node_reviews "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/ReviewService.java"
click node_payment "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/PaymentService.java"
click node_aba "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/payment/AbaPaywayClient.java"
click node_admin_catalog "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminProductsServlet.java"
click node_admin_orders "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminOrdersServlet.java"
click node_admin_reviews "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminReviewsServlet.java"
click node_admin_ops "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminReportsServlet.java"
click node_admin_support "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/SupportChannelService.java"
click node_admin_users "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminUsersServlet.java"
click node_filters "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/filter/security/AuthenticationFilter.java"
click node_realtime "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/realtime/EventHub.java"
click node_experience "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/PageExperienceService.java"
click node_metrics "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/monitoring/MetricsCollector.java"
click node_cache "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/cache/CacheManager.java"
click node_database "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/persistence/DBConnection.java"
click node_product_repo "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/repository/ProductRepository.java"
click node_review_repo "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/repository/ReviewRepository.java"
click node_user_repo "https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/repository/UserRepository.java"

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_storefront,node_auth,node_checkout,node_orders,node_filters toneBlue
class node_cart,node_catalog,node_reviews,node_payment,node_product_repo,node_review_repo,node_user_repo toneAmber
class node_admin_catalog,node_admin_orders,node_admin_reviews,node_admin_ops,node_admin_support,node_admin_users toneMint
class node_aba,node_realtime,node_experience,node_metrics,node_cache,node_database toneRose
class node_customer,node_operator toneIndigo
```

## Components

### Web entry points

- [Storefront](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/ProductServlet.java): `computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/ProductServlet.java`
- [Account access](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/AuthService.java): `computerstore/src/main/java/com/hengtongan/computerstore/core/service/AuthService.java`
- [Checkout](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/CheckoutServlet.java): `computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/CheckoutServlet.java`
- [Order history](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/CustomerOrdersServlet.java): `computerstore/src/main/java/com/hengtongan/computerstore/web/controller/customer/CustomerOrdersServlet.java`
- [Request filters](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/filter/security/AuthenticationFilter.java): `computerstore/src/main/java/com/hengtongan/computerstore/web/filter/security/AuthenticationFilter.java`

### Storefront commerce

- [Cart](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/CartService.java): `computerstore/src/main/java/com/hengtongan/computerstore/core/service/CartService.java`
- [Product catalogue](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/ProductService.java): `computerstore/src/main/java/com/hengtongan/computerstore/core/service/ProductService.java`
- [Customer reviews](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/ReviewService.java): `computerstore/src/main/java/com/hengtongan/computerstore/core/service/ReviewService.java`
- [Payment processing](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/PaymentService.java): `computerstore/src/main/java/com/hengtongan/computerstore/core/service/PaymentService.java`
- [Product persistence](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/repository/ProductRepository.java): `computerstore/src/main/java/com/hengtongan/computerstore/core/repository/ProductRepository.java`
- [Review persistence](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/repository/ReviewRepository.java): `computerstore/src/main/java/com/hengtongan/computerstore/core/repository/ReviewRepository.java`
- [User persistence](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/repository/UserRepository.java): `computerstore/src/main/java/com/hengtongan/computerstore/core/repository/UserRepository.java`

### Administration

- [Catalogue and stock](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminProductsServlet.java): `computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminProductsServlet.java`
- [Order management](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminOrdersServlet.java): `computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminOrdersServlet.java`
- [Review moderation](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminReviewsServlet.java): `computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminReviewsServlet.java`
- [Admin operations](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminReportsServlet.java): `computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminReportsServlet.java`
- [Support mailbox](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/SupportChannelService.java): `computerstore/src/main/java/com/hengtongan/computerstore/core/service/SupportChannelService.java`
- [User management](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminUsersServlet.java): `computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminUsersServlet.java`

### Platform services

- [ABA Payway](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/payment/AbaPaywayClient.java): `computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/payment/AbaPaywayClient.java`
- [Live events](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/realtime/EventHub.java): `computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/realtime/EventHub.java`
- [Experience monitoring](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/core/service/PageExperienceService.java): `computerstore/src/main/java/com/hengtongan/computerstore/core/service/PageExperienceService.java`
- [Metrics and health](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/monitoring/MetricsCollector.java): `computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/monitoring/MetricsCollector.java`
- [Application cache](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/cache/CacheManager.java): `computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/cache/CacheManager.java`
- [Store database](https://github.com/hengtongan/jakarta-project/blob/main/computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/persistence/DBConnection.java): `computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/persistence/DBConnection.java`

### Other components

- **Customer**
- **Store admin**

## Connections

- Customer → Storefront: browses (evidence: `README.md`)
- Customer → Account access: manages account (evidence: `README.md`)
- Customer → Checkout: checks out (evidence: `README.md`)
- Customer → Order history: views orders (evidence: `README.md`)
- Store admin → Catalogue and stock: manages catalogue (evidence: `README.md`)
- Store admin → Order management: manages orders (evidence: `README.md`)
- Store admin → Review moderation: moderates (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminReviewsServlet.java`)
- Store admin → Admin operations: reviews reports (evidence: `README.md`)
- Store admin → Support mailbox: handles mail (evidence: `README.md`)
- Store admin → User management: manages users (evidence: `README.md`)
- Storefront → Product catalogue: loads products
- Storefront → Customer reviews: shows reviews
- Checkout → Cart: uses cart
- Checkout → Payment processing: starts payment
- Checkout → Order history: creates order
- Payment processing → ABA Payway: requests gateway (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/service/PaymentService.java`)
- Review moderation → Customer reviews: moderates via (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/web/controller/admin/AdminReviewsServlet.java`)
- Customer reviews → Review persistence: reads and writes (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/service/ReviewService.java`)
- Customer reviews → Product catalogue: checks product (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/service/ReviewService.java`)
- Customer reviews → Live events: publishes count (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/service/ReviewService.java`)
- Account access → User persistence: reads and creates (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/service/AuthService.java`)
- Product catalogue → Product persistence: loads products (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/service/ProductService.java`)
- Product persistence → Store database: queries (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/repository/ProductRepository.java`)
- Review persistence → Store database: queries (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/repository/ReviewRepository.java`)
- User persistence → Store database: queries (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/repository/UserRepository.java`)
- Product catalogue → Application cache: uses cache (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/service/ProductService.java`)
- Customer reviews → Application cache: invalidates (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/core/service/ReviewService.java`)
- Request filters → Storefront: guards requests
- Request filters → Checkout: guards requests
- Experience monitoring → Metrics and health: records experience
- Application cache → Metrics and health: records misses (evidence: `computerstore/src/main/java/com/hengtongan/computerstore/infrastructure/cache/CacheManager.java`)
- Customer → Experience monitoring: reports experience
- Catalogue and stock → Product persistence: manages products
- Order management → Order history: manages status
