# artificialsw/app-backend architecture

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

- Interactive diagram: https://gitdiagram.com/artificialsw/app-backend
- Repository: https://github.com/artificialsw/app-backend

## Overview

This is a Spring backend for a family-oriented creative community: users join a family, exchange personal and public questions, and build shared puzzle and archive content. The main workflows run from authenticated API controllers through domain services to persistence; signup issues JWTs, while community interactions and puzzle completion contribute to family features. The README describes branch practices, not product behavior, so capability coverage is based on the source tree and excerpts. Some controller and service internals were not sampled; uncertain cross-feature links are omitted.

Main entry points: [`artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/service/SignUpService.java`](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/service/SignUpService.java) (Signup and login), [`artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageService.java`](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageService.java) (Profile and history), [`artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityController.java`](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityController.java) (Community API), [`artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityService.java`](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityService.java) (Questions and interactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity"]
  node_signup_api["Signup API"]
  node_signup_service["Signup and login<br/>[SignUpService.java]"]
  node_family_store[("Family records")]
  node_user_store[("User records")]
  node_jwt["JWT utility<br/>[JwtUtil.java]"]
end

subgraph group_community["Community"]
  node_community_api["Community API"]
  node_community_service["Questions and interactions"]
  node_community_data[("Community records")]
  node_prediction["AI prediction"]
  node_flower["Flower rewards<br/>[FlowerService.java]"]
end

subgraph group_puzzle["Puzzle and archive"]
  node_puzzle_api["Puzzle API"]
  node_puzzle_service["Puzzle lifecycle"]
  node_puzzle_data[("Puzzle records")]
  node_archive_api["Archive API"]
  node_archive_service["Family archive"]
  node_archive_data[("Archive records")]
end

subgraph group_account["Family accounts"]
  node_mypage_api["My page API"]
  node_mypage_service["Profile and history<br/>[MyPageService.java]"]
end

node_user(("User"))

node_user -->|"submits"| node_signup_api
node_signup_api -.->|"calls"| node_signup_service
node_signup_service -->|"looks up family"| node_family_store
node_signup_service -->|"saves user"| node_user_store
node_signup_service -->|"issues token"| node_jwt
node_user -->|"requests"| node_community_api
node_community_api -->|"calls"| node_community_service
node_community_api -.->|"validates token"| node_jwt
node_community_service -->|"reads and writes"| node_community_data
node_community_service -.->|"uses prediction result"| node_flower
node_puzzle_api -.->|"calls"| node_puzzle_service
node_puzzle_service -->|"reads and writes"| node_puzzle_data
node_puzzle_service -->|"uses archive records"| node_archive_data
node_archive_api -.->|"calls"| node_archive_service
node_archive_service -->|"reads and writes"| node_archive_data
node_user -->|"requests"| node_mypage_api
node_mypage_api -.->|"calls"| node_mypage_service
node_mypage_service -->|"reads profile"| node_user_store
node_mypage_service -->|"reads activity"| node_community_data
node_mypage_service -->|"reads completions"| node_puzzle_data
node_flower -->|"selects tree"| node_archive_data
node_flower -->|"saves flower"| node_community_data

click node_signup_api "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/controller/SignUpController.java"
click node_signup_service "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/service/SignUpService.java"
click node_family_store "https://github.com/artificialsw/app-backend/tree/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/entity"
click node_user_store "https://github.com/artificialsw/app-backend/tree/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/entity"
click node_jwt "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/util/JwtUtil.java"
click node_community_api "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityController.java"
click node_community_service "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityService.java"
click node_community_data "https://github.com/artificialsw/app-backend/tree/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/entity"
click node_prediction "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/service/PredictionService.java"
click node_flower "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/service/FlowerService.java"
click node_puzzle_api "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/PuzzlePictureController.java"
click node_puzzle_service "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/PuzzlePictureService.java"
click node_puzzle_data "https://github.com/artificialsw/app-backend/tree/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/entity"
click node_archive_api "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/ArchiveController.java"
click node_archive_service "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/ArchiveService.java"
click node_archive_data "https://github.com/artificialsw/app-backend/tree/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/entity"
click node_mypage_api "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageController.java"
click node_mypage_service "https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageService.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_signup_api,node_signup_service,node_family_store,node_user_store,node_jwt,node_user toneBlue
class node_community_api,node_community_service,node_community_data,node_prediction,node_flower toneAmber
class node_puzzle_api,node_puzzle_service,node_puzzle_data,node_archive_api,node_archive_service,node_archive_data toneMint
class node_mypage_api,node_mypage_service toneRose
```

## Components

### Identity

- [Signup API](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/controller/SignUpController.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/controller/SignUpController.java`
- [Signup and login](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/service/SignUpService.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/service/SignUpService.java`
- [Family records](https://github.com/artificialsw/app-backend/tree/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/entity): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/entity`
- [User records](https://github.com/artificialsw/app-backend/tree/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/entity): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/entity`
- [JWT utility](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/util/JwtUtil.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/util/JwtUtil.java`

### Community

- [Community API](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityController.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityController.java`
- [Questions and interactions](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityService.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityService.java`
- [Community records](https://github.com/artificialsw/app-backend/tree/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/entity): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/entity`
- [AI prediction](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/service/PredictionService.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/service/PredictionService.java`
- [Flower rewards](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/service/FlowerService.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/service/FlowerService.java`

### Puzzle and archive

- [Puzzle API](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/PuzzlePictureController.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/PuzzlePictureController.java`
- [Puzzle lifecycle](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/PuzzlePictureService.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/PuzzlePictureService.java`
- [Puzzle records](https://github.com/artificialsw/app-backend/tree/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/entity): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/entity`
- [Archive API](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/ArchiveController.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/ArchiveController.java`
- [Family archive](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/ArchiveService.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/ArchiveService.java`
- [Archive records](https://github.com/artificialsw/app-backend/tree/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/entity): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/entity`

### Family accounts

- [My page API](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageController.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageController.java`
- [Profile and history](https://github.com/artificialsw/app-backend/blob/main/artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageService.java): `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageService.java`

### Other components

- **User**

## Connections

- User → Signup API: submits
- Signup API → Signup and login: calls (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/controller/SignUpController.java`)
- Signup and login → Family records: looks up family (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/service/SignUpService.java`)
- Signup and login → User records: saves user (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/service/SignUpService.java`)
- Signup and login → JWT utility: issues token (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/signup/service/SignUpService.java`)
- User → Community API: requests
- Community API → Questions and interactions: calls (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityController.java`)
- Community API → JWT utility: validates token (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityController.java`)
- Questions and interactions → Community records: reads and writes (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityService.java`)
- Questions and interactions → Flower rewards: uses prediction result (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/CommunityService.java`)
- Puzzle API → Puzzle lifecycle: calls (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/PuzzlePictureController.java`)
- Puzzle lifecycle → Puzzle records: reads and writes (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/PuzzlePictureService.java`)
- Puzzle lifecycle → Archive records: uses archive records (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/puzzle/PuzzlePictureService.java`)
- Archive API → Family archive: calls (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/ArchiveController.java`)
- Family archive → Archive records: reads and writes (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/archive/ArchiveService.java`)
- User → My page API: requests
- My page API → Profile and history: calls (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageController.java`)
- Profile and history → User records: reads profile (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageService.java`)
- Profile and history → Community records: reads activity (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageService.java`)
- Profile and history → Puzzle records: reads completions (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/mypage/MyPageService.java`)
- Flower rewards → Archive records: selects tree (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/service/FlowerService.java`)
- Flower rewards → Community records: saves flower (evidence: `artificialsw-backend/src/main/java/org/dcode/artificialswbackend/community/service/FlowerService.java`)
