# 100-hours-a-week/18-team-18team-be architecture

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

- Interactive diagram: https://gitdiagram.com/100-hours-a-week/18-team-18team-be
- Repository: https://github.com/100-hours-a-week/18-team-18team-be

## Overview

Bizkit is a business-card networking backend. Its user-facing capabilities span Kakao login, user profiles and detailed work histories, card creation and collection, AI-assisted card imagery/analysis, and real-time chat; reviews and account withdrawal are additional domain branches. The excerpts and source index support several service-to-repository and service-to-integration relationships. Other workflow links are documented only as capabilities, so those are shown as unverified rather than asserted calls.

Main entry points: [`src/main/java/com/caro/bizkit/domain/auth/service/AuthService.java`](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/auth/service/AuthService.java) (Authentication), [`src/main/java/com/caro/bizkit/domain/ai/service/AiAnalysisService.java`](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/ai/service/AiAnalysisService.java) (AI Analysis), [`src/main/java/com/caro/bizkit/domain/user/service/UserService.java`](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/user/service/UserService.java) (User Profiles), [`src/main/java/com/caro/bizkit/domain/card/service/CardService.java`](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/card/service/CardService.java) (Business Cards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and Profiles"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_kakao["Kakao OAuth"]
  node_jwt["JWT and Refresh"]
  node_users["User Profiles<br/>[UserService.java]"]
  node_userstore[("User Records")]
  node_userdetails["User Details"]
  node_withdrawal["Account Withdrawal"]
end

subgraph group_networking["Cards and Networking"]
  node_cards["Business Cards<br/>[CardService.java]"]
  node_cardstore[("Card Records")]
  node_wallet["Card Wallet<br/>[WalletService.java]"]
  node_reviews["Reviews and Tags"]
end

subgraph group_realtime["Realtime and AI"]
  node_chatrooms["Chat Rooms"]
  node_chatmessages["Chat Messages"]
  node_redischat["Chat Pub/Sub"]
  node_websocket["WebSocket and STOMP"]
  node_ai["AI Analysis"]
  node_aiclient["AI Server Client"]
  node_aitasks[("Analysis Tasks")]
end

subgraph group_platform["Platform Services"]
  node_s3["Image Storage<br/>[S3Service.java]"]
  node_aws[("AWS S3")]
  node_mysql[("MySQL")]
  node_redis[("Redis")]
  node_apiresponse["API Responses<br/>[ApiResponse.java]"]
end

node_client(("Client"))

node_client -.->|"signs in"| node_auth
node_auth -->|"requests OAuth"| node_kakao
node_auth -->|"issues tokens"| node_jwt
node_auth -->|"looks up users"| node_userstore
node_client -.->|"manages profile"| node_users
node_users -->|"reads and updates"| node_userstore
node_users -->|"uses image URLs"| node_s3
node_client -.->|"creates or registers"| node_cards
node_cards -->|"queries cards"| node_cardstore
node_client -.->|"collects cards"| node_wallet
node_client -.->|"manages details"| node_userdetails
node_client -.->|"writes reviews"| node_reviews
node_client -.->|"starts chats"| node_chatrooms
node_chatrooms -->|"looks up cards"| node_cardstore
node_chatrooms -->|"uses image URLs"| node_s3
node_client -.->|"connects for chat"| node_websocket
node_websocket -.->|"routes messages"| node_chatmessages
node_chatmessages -.->|"publishes events"| node_redischat
node_redischat -.->|"publishes messages"| node_redis
node_client -.->|"requests AI imagery"| node_ai
node_ai -->|"submits analysis"| node_aiclient
node_ai -->|"tracks tasks"| node_aitasks
node_ai -->|"uses card data"| node_cardstore
node_s3 -->|"presigns and deletes"| node_aws
node_cards -.->|"persists card data"| node_mysql
node_client -.->|"withdraws account"| node_withdrawal
node_client -.->|"receives responses"| node_apiresponse

click node_auth "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/auth/service/AuthService.java"
click node_kakao "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/auth/service/KakaoOAuthClient.java"
click node_jwt "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/security/RefreshTokenService.java"
click node_users "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/user/service/UserService.java"
click node_userstore "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/user/repository/UserRepository.java"
click node_userdetails "https://github.com/100-hours-a-week/18-team-18team-be/tree/main/src/main/java/com/caro/bizkit/domain/userdetail"
click node_cards "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/card/service/CardService.java"
click node_cardstore "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/card/repository/CardRepository.java"
click node_wallet "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/card/service/WalletService.java"
click node_reviews "https://github.com/100-hours-a-week/18-team-18team-be/tree/main/src/main/java/com/caro/bizkit/domain/review"
click node_chatrooms "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/chat/service/ChatRoomService.java"
click node_chatmessages "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/chat/service/ChatMessageService.java"
click node_redischat "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/chat/service/ChatRedisPublisher.java"
click node_websocket "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/chat/config/WebSocketConfig.java"
click node_ai "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/ai/service/AiAnalysisService.java"
click node_aiclient "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/ai/client/AiAnalysisClient.java"
click node_aitasks "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/ai/repository/AiAnalysisTaskRepository.java"
click node_s3 "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/common/S3/service/S3Service.java"
click node_apiresponse "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/common/ApiResponse/ApiResponse.java"
click node_withdrawal "https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/withdrawl/service/WithdrawalService.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,node_kakao,node_jwt,node_users,node_userstore,node_userdetails,node_withdrawal,node_client toneBlue
class node_cards,node_cardstore,node_wallet,node_reviews toneAmber
class node_chatrooms,node_chatmessages,node_redischat,node_websocket,node_ai,node_aiclient,node_aitasks toneMint
class node_s3,node_aws,node_mysql,node_redis,node_apiresponse toneRose
```

## Components

### Identity and Profiles

- [Authentication](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/auth/service/AuthService.java): `src/main/java/com/caro/bizkit/domain/auth/service/AuthService.java`
- [Kakao OAuth](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/auth/service/KakaoOAuthClient.java): `src/main/java/com/caro/bizkit/domain/auth/service/KakaoOAuthClient.java`
- [JWT and Refresh](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/security/RefreshTokenService.java): `src/main/java/com/caro/bizkit/security/RefreshTokenService.java`
- [User Profiles](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/user/service/UserService.java): `src/main/java/com/caro/bizkit/domain/user/service/UserService.java`
- [User Records](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/user/repository/UserRepository.java): `src/main/java/com/caro/bizkit/domain/user/repository/UserRepository.java`
- [User Details](https://github.com/100-hours-a-week/18-team-18team-be/tree/main/src/main/java/com/caro/bizkit/domain/userdetail): `src/main/java/com/caro/bizkit/domain/userdetail`
- [Account Withdrawal](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/withdrawl/service/WithdrawalService.java): `src/main/java/com/caro/bizkit/domain/withdrawl/service/WithdrawalService.java`

### Cards and Networking

- [Business Cards](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/card/service/CardService.java): `src/main/java/com/caro/bizkit/domain/card/service/CardService.java`
- [Card Records](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/card/repository/CardRepository.java): `src/main/java/com/caro/bizkit/domain/card/repository/CardRepository.java`
- [Card Wallet](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/card/service/WalletService.java): `src/main/java/com/caro/bizkit/domain/card/service/WalletService.java`
- [Reviews and Tags](https://github.com/100-hours-a-week/18-team-18team-be/tree/main/src/main/java/com/caro/bizkit/domain/review): `src/main/java/com/caro/bizkit/domain/review`

### Realtime and AI

- [Chat Rooms](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/chat/service/ChatRoomService.java): `src/main/java/com/caro/bizkit/domain/chat/service/ChatRoomService.java`
- [Chat Messages](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/chat/service/ChatMessageService.java): `src/main/java/com/caro/bizkit/domain/chat/service/ChatMessageService.java`
- [Chat Pub/Sub](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/chat/service/ChatRedisPublisher.java): `src/main/java/com/caro/bizkit/domain/chat/service/ChatRedisPublisher.java`
- [WebSocket and STOMP](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/chat/config/WebSocketConfig.java): `src/main/java/com/caro/bizkit/domain/chat/config/WebSocketConfig.java`
- [AI Analysis](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/ai/service/AiAnalysisService.java): `src/main/java/com/caro/bizkit/domain/ai/service/AiAnalysisService.java`
- [AI Server Client](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/ai/client/AiAnalysisClient.java): `src/main/java/com/caro/bizkit/domain/ai/client/AiAnalysisClient.java`
- [Analysis Tasks](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/domain/ai/repository/AiAnalysisTaskRepository.java): `src/main/java/com/caro/bizkit/domain/ai/repository/AiAnalysisTaskRepository.java`

### Platform Services

- [Image Storage](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/common/S3/service/S3Service.java): `src/main/java/com/caro/bizkit/common/S3/service/S3Service.java`
- **AWS S3**
- **MySQL**
- **Redis**
- [API Responses](https://github.com/100-hours-a-week/18-team-18team-be/blob/main/src/main/java/com/caro/bizkit/common/ApiResponse/ApiResponse.java): `src/main/java/com/caro/bizkit/common/ApiResponse/ApiResponse.java`

### Other components

- **Client**

## Connections

- Client → Authentication: signs in (evidence: `README.md`)
- Authentication → Kakao OAuth: requests OAuth (evidence: `src/main/java/com/caro/bizkit/domain/auth/service/AuthService.java`)
- Authentication → JWT and Refresh: issues tokens (evidence: `src/main/java/com/caro/bizkit/domain/auth/service/AuthService.java`)
- Authentication → User Records: looks up users (evidence: `src/main/java/com/caro/bizkit/domain/auth/service/AuthService.java`)
- Client → User Profiles: manages profile (evidence: `README.md`)
- User Profiles → User Records: reads and updates (evidence: `src/main/java/com/caro/bizkit/domain/user/service/UserService.java`)
- User Profiles → Image Storage: uses image URLs (evidence: `src/main/java/com/caro/bizkit/domain/user/service/UserService.java`)
- Client → Business Cards: creates or registers (evidence: `README.md`)
- Business Cards → Card Records: queries cards (evidence: `src/main/java/com/caro/bizkit/domain/card/service/CardService.java`)
- Client → Card Wallet: collects cards (evidence: `README.md`)
- Client → User Details: manages details (evidence: `README.md`)
- Client → Reviews and Tags: writes reviews (evidence: `README.md`)
- Client → Chat Rooms: starts chats (evidence: `README.md`)
- Chat Rooms → Card Records: looks up cards (evidence: `src/main/java/com/caro/bizkit/domain/chat/service/ChatRoomService.java`)
- Chat Rooms → Image Storage: uses image URLs (evidence: `src/main/java/com/caro/bizkit/domain/chat/service/ChatRoomService.java`)
- Client → WebSocket and STOMP: connects for chat (evidence: `README.md`)
- WebSocket and STOMP → Chat Messages: routes messages
- Chat Messages → Chat Pub/Sub: publishes events (evidence: `src/main/java/com/caro/bizkit/domain/chat/service/ChatMessageService.java`)
- Chat Pub/Sub → Redis: publishes messages (evidence: `README.md`)
- Client → AI Analysis: requests AI imagery (evidence: `README.md`)
- AI Analysis → AI Server Client: submits analysis (evidence: `src/main/java/com/caro/bizkit/domain/ai/service/AiAnalysisService.java`)
- AI Analysis → Analysis Tasks: tracks tasks (evidence: `src/main/java/com/caro/bizkit/domain/ai/service/AiAnalysisService.java`)
- AI Analysis → Card Records: uses card data (evidence: `src/main/java/com/caro/bizkit/domain/ai/service/AiAnalysisService.java`)
- Image Storage → AWS S3: presigns and deletes (evidence: `src/main/java/com/caro/bizkit/common/S3/service/S3Service.java`)
- Business Cards → MySQL: persists card data (evidence: `README.md`)
- Client → Account Withdrawal: withdraws account (evidence: `README.md`)
- Client → API Responses: receives responses (evidence: `README.md`)
