# jabezasir421-afk/backend architecture

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

## Overview

BlueCollar is a Spring backend for a skilled-worker marketplace. Customers discover workers and create bookings; workers manage availability and complete jobs; customers can then review them. The graph also includes portfolio/file handling, authentication, notifications, analytics, and administration because these are major documented capabilities. Relationships are limited to those shown in the README, SOURCE INDEX, or excerpts; unsampled implementation links are omitted rather than inferred.

Main entry points: [`src/main/java/com/bluecollar/storage/service/LocalFileStorageService.java`](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/storage/service/LocalFileStorageService.java) (File storage), [`src/main/java/com/bluecollar/review/service/ReviewService.java`](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/review/service/ReviewService.java) (Reviews and moderation), [`src/main/java/com/bluecollar/auth/service/AuthServiceImpl.java`](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/auth/service/AuthServiceImpl.java) (Authentication), [`src/main/java/com/bluecollar/portfolio/service/PortfolioServiceImpl.java`](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/portfolio/service/PortfolioServiceImpl.java) (Worker portfolios)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_market["Marketplace workflow"]
  node_search["Worker discovery"]
  node_category["Service categories"]
  node_skill["Worker skills"]
  node_availability["Availability scheduling"]
  node_booking["Booking lifecycle"]
  node_reviews["Reviews and moderation<br/>[ReviewService.java]"]
end

subgraph group_identity["Identity and profiles"]
  node_customer["Customer profiles"]
  node_worker["Worker profiles"]
  node_auth["Authentication"]
  node_jwt["JWT tokens<br/>[JwtService.java]"]
  node_portfolio["Worker portfolios"]
end

subgraph group_platform["Platform operations"]
  node_storage["File storage"]
  node_filemeta[("Stored file metadata")]
  node_notifications["Notifications"]
  node_audit["Audit logging"]
end

subgraph group_insights["Administration and insights"]
  node_admin["Admin management"]
  node_analytics["Analytics snapshots"]
end

node_actor(("Marketplace users"))
node_localfs[("Local filesystem")]

node_actor -->|"search workers"| node_search
node_actor -->|"request service"| node_booking
node_actor -->|"manage schedule"| node_availability
node_actor -->|"authenticate"| node_auth
node_actor -->|"review or report"| node_reviews
node_auth -->|"issue and validate"| node_jwt
node_actor -->|"manage portfolio"| node_portfolio
node_actor -.->|"manage profile"| node_customer
node_actor -.->|"manage profile"| node_worker
node_actor -.->|"browse categories"| node_category
node_actor -.->|"manage skills"| node_skill
node_portfolio -.->|"store documents"| node_storage
node_storage -->|"read and write"| node_localfs
node_storage -.->|"track file metadata"| node_filemeta
node_actor -->|"receive alerts"| node_notifications
node_actor -.->|"administer platform"| node_admin
node_actor -->|"view trends"| node_analytics
node_actor -->|"sensitive operations logged"| node_audit
node_actor -->|"moderate reviews"| node_reviews
node_actor -->|"create and report reviews"| node_reviews

click node_customer "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/customer/service/CustomerServiceImpl.java"
click node_worker "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/worker/service/WorkerServiceImpl.java"
click node_auth "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/auth/service/AuthServiceImpl.java"
click node_jwt "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/auth/security/JwtService.java"
click node_portfolio "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/portfolio/service/PortfolioServiceImpl.java"
click node_search "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/search/service/WorkerSearchServiceImpl.java"
click node_category "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/category/service/CategoryServiceImpl.java"
click node_skill "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/skill/service/SkillServiceImpl.java"
click node_availability "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/availability/service/AvailabilityServiceImpl.java"
click node_booking "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/booking/service/BookingServiceImpl.java"
click node_reviews "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/review/service/ReviewService.java"
click node_storage "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/storage/service/LocalFileStorageService.java"
click node_filemeta "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/storage/service/StoredFileServiceImpl.java"
click node_notifications "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/notification/service/NotificationServiceImpl.java"
click node_audit "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/audit/service/AuditLogService.java"
click node_admin "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/admin/service/AdminDashboardServiceImpl.java"
click node_analytics "https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/analytics/service/AnalyticsServiceImpl.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_search,node_category,node_skill,node_availability,node_booking,node_reviews,node_actor toneBlue
class node_customer,node_worker,node_auth,node_jwt,node_portfolio,node_localfs toneAmber
class node_storage,node_filemeta,node_notifications,node_audit toneMint
class node_admin,node_analytics toneRose
```

## Components

### Marketplace workflow

- [Worker discovery](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/search/service/WorkerSearchServiceImpl.java): `src/main/java/com/bluecollar/search/service/WorkerSearchServiceImpl.java`
- [Service categories](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/category/service/CategoryServiceImpl.java): `src/main/java/com/bluecollar/category/service/CategoryServiceImpl.java`
- [Worker skills](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/skill/service/SkillServiceImpl.java): `src/main/java/com/bluecollar/skill/service/SkillServiceImpl.java`
- [Availability scheduling](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/availability/service/AvailabilityServiceImpl.java): `src/main/java/com/bluecollar/availability/service/AvailabilityServiceImpl.java`
- [Booking lifecycle](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/booking/service/BookingServiceImpl.java): `src/main/java/com/bluecollar/booking/service/BookingServiceImpl.java`
- [Reviews and moderation](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/review/service/ReviewService.java): `src/main/java/com/bluecollar/review/service/ReviewService.java`

### Identity and profiles

- [Customer profiles](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/customer/service/CustomerServiceImpl.java): `src/main/java/com/bluecollar/customer/service/CustomerServiceImpl.java`
- [Worker profiles](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/worker/service/WorkerServiceImpl.java): `src/main/java/com/bluecollar/worker/service/WorkerServiceImpl.java`
- [Authentication](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/auth/service/AuthServiceImpl.java): `src/main/java/com/bluecollar/auth/service/AuthServiceImpl.java`
- [JWT tokens](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/auth/security/JwtService.java): `src/main/java/com/bluecollar/auth/security/JwtService.java`
- [Worker portfolios](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/portfolio/service/PortfolioServiceImpl.java): `src/main/java/com/bluecollar/portfolio/service/PortfolioServiceImpl.java`

### Platform operations

- [File storage](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/storage/service/LocalFileStorageService.java): `src/main/java/com/bluecollar/storage/service/LocalFileStorageService.java`
- [Stored file metadata](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/storage/service/StoredFileServiceImpl.java): `src/main/java/com/bluecollar/storage/service/StoredFileServiceImpl.java`
- [Notifications](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/notification/service/NotificationServiceImpl.java): `src/main/java/com/bluecollar/notification/service/NotificationServiceImpl.java`
- [Audit logging](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/audit/service/AuditLogService.java): `src/main/java/com/bluecollar/audit/service/AuditLogService.java`

### Administration and insights

- [Admin management](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/admin/service/AdminDashboardServiceImpl.java): `src/main/java/com/bluecollar/admin/service/AdminDashboardServiceImpl.java`
- [Analytics snapshots](https://github.com/jabezasir421-afk/backend/blob/main/src/main/java/com/bluecollar/analytics/service/AnalyticsServiceImpl.java): `src/main/java/com/bluecollar/analytics/service/AnalyticsServiceImpl.java`

### Other components

- **Marketplace users**
- **Local filesystem**

## Connections

- Marketplace users → Worker discovery: search workers
- Marketplace users → Booking lifecycle: request service
- Marketplace users → Availability scheduling: manage schedule
- Marketplace users → Authentication: authenticate
- Marketplace users → Reviews and moderation: review or report
- Authentication → JWT tokens: issue and validate (evidence: `src/main/java/com/bluecollar/auth/security/JwtService.java`)
- Marketplace users → Worker portfolios: manage portfolio
- Marketplace users → Customer profiles: manage profile
- Marketplace users → Worker profiles: manage profile
- Marketplace users → Service categories: browse categories
- Marketplace users → Worker skills: manage skills
- Worker portfolios → File storage: store documents
- File storage → Local filesystem: read and write (evidence: `src/main/java/com/bluecollar/storage/service/LocalFileStorageService.java`)
- File storage → Stored file metadata: track file metadata
- Marketplace users → Notifications: receive alerts
- Marketplace users → Admin management: administer platform
- Marketplace users → Analytics snapshots: view trends
- Marketplace users → Audit logging: sensitive operations logged
- Marketplace users → Reviews and moderation: moderate reviews
- Marketplace users → Reviews and moderation: create and report reviews
