# danieltran05/cosmeticproj architecture

> Architecture diagram of the GitHub repository danieltran05/cosmeticproj, 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/danieltran05/cosmeticproj
- Repository: https://github.com/danieltran05/cosmeticproj

## Overview

CosmeMgt is a cosmetics-commerce management backend spanning identity and permissions, product catalog, promotions, ordering and payment, warehouse operations, reviews, and reporting. The principal customer workflow is browsing products, placing an order, paying, then following fulfillment; staff manage catalog, inventory, and order processing. The tree establishes these subsystems, but README content is absent and most controller/service wiring was not sampled, so those links are shown as unverified rather than asserted. Solid links reflect the sampled source or SOURCE INDEX references.

Main entry points: [`src/main/java/com/dtp/cosmemgt/catalog/service/query/ProductQueryService.java`](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/catalog/service/query/ProductQueryService.java) (Product queries), [`src/main/java/com/dtp/cosmemgt/catalog/controller/customer/ProductController.java`](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/catalog/controller/customer/ProductController.java) (Catalog APIs), [`src/main/java/com/dtp/cosmemgt/sales/order/controller/OrderController.java`](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/controller/OrderController.java) (Order APIs), [`src/main/java/com/dtp/cosmemgt/sales/order/service/command/PlaceOrderService.java`](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/service/command/PlaceOrderService.java) (Order placement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth_api["Authentication API"]
  node_auth_service["Authentication"]
  node_user_store[("User records<br/>[User.java]")]
end

subgraph group_catalog["Catalog and promotions"]
  node_catalog_api["Catalog APIs"]
  node_product_query["Product queries"]
  node_product_store[("Product records")]
  node_category_query["Category queries"]
  node_promotion["Promotion services"]
  node_promotion_store[("Promotion records")]
end

subgraph group_sales["Sales and payments"]
  node_order_api["Order APIs"]
  node_order_place["Order placement"]
  node_cart_calc["Cart calculation"]
  node_order_query["Order queries"]
  node_order_store[("Order records")]
  node_payment["Payment providers"]
  node_reviews["Product reviews<br/>[ReviewService.java]"]
  node_review_api["Review API"]
end

subgraph group_warehouse["Warehouse operations"]
  node_warehouse_api["Warehouse APIs"]
  node_inbound["Inbound inventory"]
  node_warehouse_orders["Warehouse orders"]
end

subgraph group_shared["Shared capabilities"]
  node_mail["Email delivery<br/>[MailService.java]"]
  node_mail_client["Brevo client"]
  node_api_runtime["Application runtime"]
end

node_customer(("Customer"))
node_staff(("Staff"))

node_customer -.->|"authenticates"| node_auth_api
node_staff -.->|"authenticates"| node_auth_api
node_auth_api -.->|"delegates"| node_auth_service
node_auth_service -->|"reads users"| node_user_store
node_customer -.->|"browses"| node_catalog_api
node_catalog_api -.->|"queries"| node_product_query
node_product_query -->|"reads products"| node_product_store
node_product_query -->|"calculates discounts"| node_promotion
node_product_query -->|"reads promotions"| node_promotion_store
node_catalog_api -.->|"queries"| node_category_query
node_category_query -->|"reads categories"| node_product_store
node_customer -.->|"places orders"| node_order_api
node_order_api -.->|"delegates"| node_order_place
node_order_api -.->|"calculates cart"| node_cart_calc
node_order_place -.->|"initiates payment"| node_payment
node_order_query -->|"queries orders"| node_order_store
node_order_place -.->|"writes orders"| node_order_store
node_customer -.->|"submits reviews"| node_review_api
node_review_api -->|"delegates"| node_reviews
node_staff -.->|"manages stock"| node_warehouse_api
node_warehouse_api -.->|"delegates"| node_inbound
node_inbound -->|"reads product data"| node_product_store
node_staff -.->|"fulfills orders"| node_warehouse_orders
node_mail -->|"sends email"| node_mail_client

click node_auth_api "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/admin/controller/AuthenticationController.java"
click node_auth_service "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/admin/service/AuthenticationService.java"
click node_user_store "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/admin/entity/User.java"
click node_catalog_api "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/catalog/controller/customer/ProductController.java"
click node_product_query "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/catalog/service/query/ProductQueryService.java"
click node_product_store "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/catalog/repository/ProductRepository.java"
click node_category_query "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/catalog/service/query/CategoryQueryService.java"
click node_promotion "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/promotion/service/PromotionCalculator.java"
click node_promotion_store "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/promotion/repository/PromotionRepository.java"
click node_order_api "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/controller/OrderController.java"
click node_order_place "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/service/command/PlaceOrderService.java"
click node_cart_calc "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/service/command/CartCalculationService.java"
click node_order_query "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/service/query/OrderQueryService.java"
click node_order_store "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/repository/OrderRepository.java"
click node_payment "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/payment/service/impl/VNPayPaymentService.java"
click node_reviews "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/review/service/ReviewService.java"
click node_review_api "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/review/controller/ReviewController.java"
click node_warehouse_api "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/warehouse/controller/WarehouseInboundController.java"
click node_inbound "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/warehouse/service/WarehouseInboundService.java"
click node_warehouse_orders "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/warehouse/service/WarehouseOrderService.java"
click node_mail "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/core/commonService/MailService.java"
click node_mail_client "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/core/commonService/BrevoMailClient.java"
click node_api_runtime "https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/CosmeMgtApplication.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_auth_api,node_auth_service,node_user_store toneBlue
class node_catalog_api,node_product_query,node_product_store,node_category_query,node_promotion,node_promotion_store toneAmber
class node_order_api,node_order_place,node_cart_calc,node_order_query,node_order_store,node_payment,node_reviews,node_review_api toneMint
class node_warehouse_api,node_inbound,node_warehouse_orders toneRose
class node_mail,node_mail_client,node_api_runtime,node_customer,node_staff toneIndigo
```

## Components

### Identity and access

- [Authentication API](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/admin/controller/AuthenticationController.java): `src/main/java/com/dtp/cosmemgt/admin/controller/AuthenticationController.java`
- [Authentication](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/admin/service/AuthenticationService.java): `src/main/java/com/dtp/cosmemgt/admin/service/AuthenticationService.java`
- [User records](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/admin/entity/User.java): `src/main/java/com/dtp/cosmemgt/admin/entity/User.java`

### Catalog and promotions

- [Catalog APIs](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/catalog/controller/customer/ProductController.java): `src/main/java/com/dtp/cosmemgt/catalog/controller/customer/ProductController.java`
- [Product queries](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/catalog/service/query/ProductQueryService.java): `src/main/java/com/dtp/cosmemgt/catalog/service/query/ProductQueryService.java`
- [Product records](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/catalog/repository/ProductRepository.java): `src/main/java/com/dtp/cosmemgt/catalog/repository/ProductRepository.java`
- [Category queries](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/catalog/service/query/CategoryQueryService.java): `src/main/java/com/dtp/cosmemgt/catalog/service/query/CategoryQueryService.java`
- [Promotion services](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/promotion/service/PromotionCalculator.java): `src/main/java/com/dtp/cosmemgt/sales/promotion/service/PromotionCalculator.java`
- [Promotion records](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/promotion/repository/PromotionRepository.java): `src/main/java/com/dtp/cosmemgt/sales/promotion/repository/PromotionRepository.java`

### Sales and payments

- [Order APIs](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/controller/OrderController.java): `src/main/java/com/dtp/cosmemgt/sales/order/controller/OrderController.java`
- [Order placement](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/service/command/PlaceOrderService.java): `src/main/java/com/dtp/cosmemgt/sales/order/service/command/PlaceOrderService.java`
- [Cart calculation](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/service/command/CartCalculationService.java): `src/main/java/com/dtp/cosmemgt/sales/order/service/command/CartCalculationService.java`
- [Order queries](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/service/query/OrderQueryService.java): `src/main/java/com/dtp/cosmemgt/sales/order/service/query/OrderQueryService.java`
- [Order records](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/order/repository/OrderRepository.java): `src/main/java/com/dtp/cosmemgt/sales/order/repository/OrderRepository.java`
- [Payment providers](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/payment/service/impl/VNPayPaymentService.java): `src/main/java/com/dtp/cosmemgt/sales/payment/service/impl/VNPayPaymentService.java`
- [Product reviews](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/review/service/ReviewService.java): `src/main/java/com/dtp/cosmemgt/sales/review/service/ReviewService.java`
- [Review API](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/sales/review/controller/ReviewController.java): `src/main/java/com/dtp/cosmemgt/sales/review/controller/ReviewController.java`

### Warehouse operations

- [Warehouse APIs](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/warehouse/controller/WarehouseInboundController.java): `src/main/java/com/dtp/cosmemgt/warehouse/controller/WarehouseInboundController.java`
- [Inbound inventory](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/warehouse/service/WarehouseInboundService.java): `src/main/java/com/dtp/cosmemgt/warehouse/service/WarehouseInboundService.java`
- [Warehouse orders](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/warehouse/service/WarehouseOrderService.java): `src/main/java/com/dtp/cosmemgt/warehouse/service/WarehouseOrderService.java`

### Shared capabilities

- [Email delivery](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/core/commonService/MailService.java): `src/main/java/com/dtp/cosmemgt/core/commonService/MailService.java`
- [Brevo client](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/core/commonService/BrevoMailClient.java): `src/main/java/com/dtp/cosmemgt/core/commonService/BrevoMailClient.java`
- [Application runtime](https://github.com/danieltran05/cosmeticproj/blob/main/src/main/java/com/dtp/cosmemgt/CosmeMgtApplication.java): `src/main/java/com/dtp/cosmemgt/CosmeMgtApplication.java`

### Other components

- **Customer**
- **Staff**

## Connections

- Customer → Authentication API: authenticates
- Staff → Authentication API: authenticates
- Authentication API → Authentication: delegates
- Authentication → User records: reads users (evidence: `src/main/java/com/dtp/cosmemgt/admin/service/AuthenticationService.java`)
- Customer → Catalog APIs: browses
- Catalog APIs → Product queries: queries
- Product queries → Product records: reads products (evidence: `src/main/java/com/dtp/cosmemgt/catalog/service/query/ProductQueryService.java`)
- Product queries → Promotion services: calculates discounts (evidence: `src/main/java/com/dtp/cosmemgt/catalog/service/query/ProductQueryService.java`)
- Product queries → Promotion records: reads promotions (evidence: `src/main/java/com/dtp/cosmemgt/catalog/service/query/ProductQueryService.java`)
- Catalog APIs → Category queries: queries
- Category queries → Product records: reads categories (evidence: `src/main/java/com/dtp/cosmemgt/catalog/service/query/CategoryQueryService.java`)
- Customer → Order APIs: places orders
- Order APIs → Order placement: delegates
- Order APIs → Cart calculation: calculates cart
- Order placement → Payment providers: initiates payment
- Order queries → Order records: queries orders (evidence: `src/main/java/com/dtp/cosmemgt/sales/order/service/query/OrderQueryService.java`)
- Order placement → Order records: writes orders (evidence: `src/main/java/com/dtp/cosmemgt/sales/order/service/command/PlaceOrderService.java`)
- Customer → Review API: submits reviews
- Review API → Product reviews: delegates (evidence: `src/main/java/com/dtp/cosmemgt/sales/review/controller/ReviewController.java`)
- Staff → Warehouse APIs: manages stock
- Warehouse APIs → Inbound inventory: delegates
- Inbound inventory → Product records: reads product data (evidence: `src/main/java/com/dtp/cosmemgt/warehouse/service/WarehouseInboundService.java`)
- Staff → Warehouse orders: fulfills orders
- Email delivery → Brevo client: sends email (evidence: `src/main/java/com/dtp/cosmemgt/core/commonService/MailService.java`)
