# thaitu-cmd/workgo architecture

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

## Overview

WorkGo appears to be a services marketplace with identity/provider onboarding and a service catalog, alongside Android and website frontends and an API gateway. The likely user journey is to authenticate, discover services, and proceed toward booking, but the README is empty and the sampled frontend code does not establish its API wiring. The graph therefore emphasizes evidenced identity and catalog internals; order and payment directories contain only application entry-point files in the supplied tree, so their runtime behavior is unclear.

Main entry points: [`identity-service/src/main/java/com/workgo/identity/service/AuthenticationService.java`](https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/service/AuthenticationService.java) (Authentication), [`api-gateway/src/main/java/com/workgo/gateway/service/IdentityService.java`](https://github.com/thaitu-cmd/workgo/blob/main/api-gateway/src/main/java/com/workgo/gateway/service/IdentityService.java) (Identity client service), [`identity-service/src/main/java/com/workgo/identity/service/ProviderProfileService.java`](https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/service/ProviderProfileService.java) (Provider profiles), [`catalog-service/src/main/java/com/workgo/catalog/service/CategoryService.java`](https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/service/CategoryService.java) (Category management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client applications"]
  node_android["Android app<br/>[index.tsx]"]
  node_website["Website<br/>[page.tsx]"]
end

subgraph group_gateway["API gateway"]
  node_gateway_app["Gateway application"]
  node_gateway_auth["Authentication filter"]
  node_identity_service["Identity client service"]
  node_identity_client["Identity HTTP client"]
end

subgraph group_identity["Identity and providers"]
  node_identity_api["Identity API"]
  node_authentication["Authentication"]
  node_user_store["User repository"]
  node_token_store["Invalidated token repository"]
  node_provider_api["Provider profile API"]
  node_provider_profiles["Provider profiles"]
  node_verification["Provider verification"]
  node_provider_store["Provider profile repository"]
end

subgraph group_catalog["Service catalog"]
  node_catalog_app["Catalog application"]
  node_category_service["Category management"]
  node_category_store["Category repository"]
  node_service_service["Service listings"]
  node_service_store["Service repository"]
  node_media_service["Service media"]
  node_media_store["Media repository"]
  node_packages["Service packages"]
end

node_user(("Marketplace user"))

node_user -.->|"uses"| node_android
node_user -.->|"uses"| node_website
node_gateway_auth -.->|"checks tokens"| node_identity_service
node_identity_service -->|"delegates to"| node_identity_client
node_identity_api -.->|"delegates to"| node_authentication
node_authentication -->|"reads users"| node_user_store
node_authentication -->|"checks invalidations"| node_token_store
node_provider_api -->|"delegates to"| node_provider_profiles
node_provider_profiles -->|"reads and saves"| node_provider_store
node_verification -->|"loads profiles"| node_provider_store
node_catalog_app -.->|"hosts"| node_category_service
node_category_service -->|"reads and saves"| node_category_store
node_service_service -->|"reads and saves"| node_service_store
node_media_service -->|"reads and saves"| node_media_store

click node_android "https://github.com/thaitu-cmd/workgo/blob/main/android-frontend/src/app/index.tsx"
click node_website "https://github.com/thaitu-cmd/workgo/blob/main/website-frontend/src/app/page.tsx"
click node_gateway_app "https://github.com/thaitu-cmd/workgo/blob/main/api-gateway/src/main/java/com/workgo/ApiGatewayApplication.java"
click node_gateway_auth "https://github.com/thaitu-cmd/workgo/blob/main/api-gateway/src/main/java/com/workgo/gateway/configuration/AuthenticationFilter.java"
click node_identity_service "https://github.com/thaitu-cmd/workgo/blob/main/api-gateway/src/main/java/com/workgo/gateway/service/IdentityService.java"
click node_identity_client "https://github.com/thaitu-cmd/workgo/blob/main/api-gateway/src/main/java/com/workgo/gateway/repository/IdentityClient.java"
click node_identity_api "https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/controller/AuthenticationController.java"
click node_authentication "https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/service/AuthenticationService.java"
click node_user_store "https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/repository/UserRepository.java"
click node_token_store "https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/repository/InvalidatedTokenRepository.java"
click node_provider_api "https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/controller/ProviderProfileController.java"
click node_provider_profiles "https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/service/ProviderProfileService.java"
click node_verification "https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/service/ProviderVerificationService.java"
click node_provider_store "https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/repository/ProviderProfileRepository.java"
click node_catalog_app "https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/CategoryServiceApplication.java"
click node_category_service "https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/service/CategoryService.java"
click node_category_store "https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/repository/CategoryRepository.java"
click node_service_service "https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/service/ServiceService.java"
click node_service_store "https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/repository/ServiceRepository.java"
click node_media_service "https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/service/ServiceMediaService.java"
click node_media_store "https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/repository/ServiceMediaRepository.java"
click node_packages "https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/service/PackageService.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_android,node_website,node_user toneBlue
class node_gateway_app,node_gateway_auth,node_identity_service,node_identity_client toneAmber
class node_identity_api,node_authentication,node_user_store,node_token_store,node_provider_api,node_provider_profiles,node_verification,node_provider_store toneMint
class node_catalog_app,node_category_service,node_category_store,node_service_service,node_service_store,node_media_service,node_media_store,node_packages toneRose
```

## Components

### Client applications

- [Android app](https://github.com/thaitu-cmd/workgo/blob/main/android-frontend/src/app/index.tsx): `android-frontend/src/app/index.tsx`
- [Website](https://github.com/thaitu-cmd/workgo/blob/main/website-frontend/src/app/page.tsx): `website-frontend/src/app/page.tsx`

### API gateway

- [Gateway application](https://github.com/thaitu-cmd/workgo/blob/main/api-gateway/src/main/java/com/workgo/ApiGatewayApplication.java): `api-gateway/src/main/java/com/workgo/ApiGatewayApplication.java`
- [Authentication filter](https://github.com/thaitu-cmd/workgo/blob/main/api-gateway/src/main/java/com/workgo/gateway/configuration/AuthenticationFilter.java): `api-gateway/src/main/java/com/workgo/gateway/configuration/AuthenticationFilter.java`
- [Identity client service](https://github.com/thaitu-cmd/workgo/blob/main/api-gateway/src/main/java/com/workgo/gateway/service/IdentityService.java): `api-gateway/src/main/java/com/workgo/gateway/service/IdentityService.java`
- [Identity HTTP client](https://github.com/thaitu-cmd/workgo/blob/main/api-gateway/src/main/java/com/workgo/gateway/repository/IdentityClient.java): `api-gateway/src/main/java/com/workgo/gateway/repository/IdentityClient.java`

### Identity and providers

- [Identity API](https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/controller/AuthenticationController.java): `identity-service/src/main/java/com/workgo/identity/controller/AuthenticationController.java`
- [Authentication](https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/service/AuthenticationService.java): `identity-service/src/main/java/com/workgo/identity/service/AuthenticationService.java`
- [User repository](https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/repository/UserRepository.java): `identity-service/src/main/java/com/workgo/identity/repository/UserRepository.java`
- [Invalidated token repository](https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/repository/InvalidatedTokenRepository.java): `identity-service/src/main/java/com/workgo/identity/repository/InvalidatedTokenRepository.java`
- [Provider profile API](https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/controller/ProviderProfileController.java): `identity-service/src/main/java/com/workgo/identity/controller/ProviderProfileController.java`
- [Provider profiles](https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/service/ProviderProfileService.java): `identity-service/src/main/java/com/workgo/identity/service/ProviderProfileService.java`
- [Provider verification](https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/service/ProviderVerificationService.java): `identity-service/src/main/java/com/workgo/identity/service/ProviderVerificationService.java`
- [Provider profile repository](https://github.com/thaitu-cmd/workgo/blob/main/identity-service/src/main/java/com/workgo/identity/repository/ProviderProfileRepository.java): `identity-service/src/main/java/com/workgo/identity/repository/ProviderProfileRepository.java`

### Service catalog

- [Catalog application](https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/CategoryServiceApplication.java): `catalog-service/src/main/java/com/workgo/catalog/CategoryServiceApplication.java`
- [Category management](https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/service/CategoryService.java): `catalog-service/src/main/java/com/workgo/catalog/service/CategoryService.java`
- [Category repository](https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/repository/CategoryRepository.java): `catalog-service/src/main/java/com/workgo/catalog/repository/CategoryRepository.java`
- [Service listings](https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/service/ServiceService.java): `catalog-service/src/main/java/com/workgo/catalog/service/ServiceService.java`
- [Service repository](https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/repository/ServiceRepository.java): `catalog-service/src/main/java/com/workgo/catalog/repository/ServiceRepository.java`
- [Service media](https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/service/ServiceMediaService.java): `catalog-service/src/main/java/com/workgo/catalog/service/ServiceMediaService.java`
- [Media repository](https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/repository/ServiceMediaRepository.java): `catalog-service/src/main/java/com/workgo/catalog/repository/ServiceMediaRepository.java`
- [Service packages](https://github.com/thaitu-cmd/workgo/blob/main/catalog-service/src/main/java/com/workgo/catalog/service/PackageService.java): `catalog-service/src/main/java/com/workgo/catalog/service/PackageService.java`

### Other components

- **Marketplace user**

## Connections

- Marketplace user → Android app: uses
- Marketplace user → Website: uses
- Authentication filter → Identity client service: checks tokens
- Identity client service → Identity HTTP client: delegates to (evidence: `api-gateway/src/main/java/com/workgo/gateway/service/IdentityService.java`)
- Identity API → Authentication: delegates to
- Authentication → User repository: reads users (evidence: `identity-service/src/main/java/com/workgo/identity/service/AuthenticationService.java`)
- Authentication → Invalidated token repository: checks invalidations (evidence: `identity-service/src/main/java/com/workgo/identity/service/AuthenticationService.java`)
- Provider profile API → Provider profiles: delegates to (evidence: `identity-service/src/main/java/com/workgo/identity/controller/ProviderProfileController.java`)
- Provider profiles → Provider profile repository: reads and saves (evidence: `identity-service/src/main/java/com/workgo/identity/service/ProviderProfileService.java`)
- Provider verification → Provider profile repository: loads profiles (evidence: `identity-service/src/main/java/com/workgo/identity/service/ProviderVerificationService.java`)
- Catalog application → Category management: hosts
- Category management → Category repository: reads and saves (evidence: `catalog-service/src/main/java/com/workgo/catalog/service/CategoryService.java`)
- Service listings → Service repository: reads and saves (evidence: `catalog-service/src/main/java/com/workgo/catalog/service/ServiceService.java`)
- Service media → Media repository: reads and saves (evidence: `catalog-service/src/main/java/com/workgo/catalog/service/ServiceMediaService.java`)
