# 2026-snapy/server architecture

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

## Overview

Snapy is a social photo-journaling backend: users authenticate, record photos in daily albums, publish and browse albums, and interact through friends, feeds, comments, and notifications. The tree also shows profiles, privacy controls, contacts, guestbooks, reporting, and media uploads as distinct product capabilities. The graph groups those capabilities and shows only service-to-repository or infrastructure calls supported by the sampled source or SOURCE INDEX; the README is empty, and most controllers and services were not sampled, so many runtime links are omitted.

Main entry points: [`src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java`](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java) (Album browsing), [`src/main/java/com/gbsw/snapy/domain/users/repository/UserRepository.java`](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/users/repository/UserRepository.java) (User records), [`src/main/java/com/gbsw/snapy/domain/auth/service`](https://github.com/2026-snapy/server/tree/main/src/main/java/com/gbsw/snapy/domain/auth/service) (OAuth and auth), [`src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java`](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java) (Friend network)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth["OAuth and auth"]
  node_phone["Phone verification"]
end

subgraph group_journaling["Photo journaling"]
  node_albums["Daily albums"]
  node_albumquery["Album browsing"]
  node_albumstore[("Album records")]
  node_photos["Photo library<br/>[PhotoService.java]"]
  node_audio["Audio uploads<br/>[AudioService.java]"]
end

subgraph group_social["Social interactions"]
  node_friends["Friend network<br/>[FriendService.java]"]
  node_friendstore[("Friend records")]
  node_feed["Social feed<br/>[FeedService.java]"]
  node_comments["Feed comments"]
  node_guestbook["Guestbooks"]
  node_contacts["Contact discovery"]
end

subgraph group_account["User and safety"]
  node_users["User profiles"]
  node_userstore[("User records")]
  node_settings["Privacy settings"]
  node_settingstore[("User settings")]
  node_blocks["User blocking"]
end

subgraph group_platform["Notifications and media"]
  node_notifications["Notifications"]
  node_devices["Device tokens"]
  node_push["Push delivery"]
  node_apns["Apple push"]
  node_fcm["Firebase push"]
  node_storage["Media storage<br/>[S3Service.java]"]
  node_s3uploader["S3 uploader<br/>[S3Uploader.java]"]
end

node_client(("Mobile clients"))
node_sms["SMS provider"]

node_auth -->|"reads/writes"| node_userstore
node_auth -->|"creates settings"| node_settingstore
node_auth -.->|"returns login result"| node_client
node_phone -->|"sends codes"| node_sms
node_phone -->|"checks users"| node_userstore
node_albumquery -->|"reads albums"| node_albumstore
node_albumquery -->|"checks visibility"| node_settingstore
node_albumquery -->|"checks friendship"| node_friendstore
node_albumquery -->|"loads users"| node_userstore
node_friends -->|"reads/writes"| node_friendstore
node_friends -->|"loads users"| node_userstore
node_friends -->|"checks blocks"| node_blocks
node_storage -->|"uploads/deletes"| node_s3uploader
node_apns -->|"looks up tokens"| node_devices
node_fcm -->|"looks up tokens"| node_devices
node_push -.->|"dispatches"| node_apns
node_push -.->|"dispatches"| node_fcm

click node_auth "https://github.com/2026-snapy/server/tree/main/src/main/java/com/gbsw/snapy/domain/auth/service"
click node_phone "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/phone/service/PhoneVerificationService.java"
click node_users "https://github.com/2026-snapy/server/tree/main/src/main/java/com/gbsw/snapy/domain/users/service"
click node_userstore "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/users/repository/UserRepository.java"
click node_settings "https://github.com/2026-snapy/server/tree/main/src/main/java/com/gbsw/snapy/domain/settings/service"
click node_settingstore "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/settings/repository/UserSettingRepository.java"
click node_albums "https://github.com/2026-snapy/server/tree/main/src/main/java/com/gbsw/snapy/domain/albums/service"
click node_albumquery "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java"
click node_albumstore "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/albums/repository/DailyAlbumRepository.java"
click node_photos "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/photos/service/PhotoService.java"
click node_audio "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/audios/service/AudioService.java"
click node_friends "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java"
click node_friendstore "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/friends/repository/FriendRepository.java"
click node_blocks "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/blocks/service/UserBlockService.java"
click node_feed "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/feed/service/FeedService.java"
click node_comments "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/comments/service/CommentService.java"
click node_guestbook "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/guestbook/service/GuestBookService.java"
click node_contacts "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/contacts/service/ContactsService.java"
click node_notifications "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/notifications/service/NotificationService.java"
click node_devices "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/device/service/DeviceTokenService.java"
click node_push "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/infra/push/PushNotificationService.java"
click node_apns "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/infra/apns/ApnsPushService.java"
click node_fcm "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/infra/fcm/FcmPushService.java"
click node_storage "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/infra/s3/S3Service.java"
click node_s3uploader "https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/infra/s3/S3Uploader.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_phone,node_client toneBlue
class node_albums,node_albumquery,node_albumstore,node_photos,node_audio toneAmber
class node_friends,node_friendstore,node_feed,node_comments,node_guestbook,node_contacts toneMint
class node_users,node_userstore,node_settings,node_settingstore,node_blocks toneRose
class node_notifications,node_devices,node_push,node_apns,node_fcm,node_storage,node_s3uploader,node_sms toneIndigo
```

## Components

### Identity and access

- [OAuth and auth](https://github.com/2026-snapy/server/tree/main/src/main/java/com/gbsw/snapy/domain/auth/service): `src/main/java/com/gbsw/snapy/domain/auth/service`
- [Phone verification](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/phone/service/PhoneVerificationService.java): `src/main/java/com/gbsw/snapy/domain/phone/service/PhoneVerificationService.java`

### Photo journaling

- [Daily albums](https://github.com/2026-snapy/server/tree/main/src/main/java/com/gbsw/snapy/domain/albums/service): `src/main/java/com/gbsw/snapy/domain/albums/service`
- [Album browsing](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java): `src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java`
- [Album records](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/albums/repository/DailyAlbumRepository.java): `src/main/java/com/gbsw/snapy/domain/albums/repository/DailyAlbumRepository.java`
- [Photo library](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/photos/service/PhotoService.java): `src/main/java/com/gbsw/snapy/domain/photos/service/PhotoService.java`
- [Audio uploads](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/audios/service/AudioService.java): `src/main/java/com/gbsw/snapy/domain/audios/service/AudioService.java`

### Social interactions

- [Friend network](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java): `src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java`
- [Friend records](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/friends/repository/FriendRepository.java): `src/main/java/com/gbsw/snapy/domain/friends/repository/FriendRepository.java`
- [Social feed](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/feed/service/FeedService.java): `src/main/java/com/gbsw/snapy/domain/feed/service/FeedService.java`
- [Feed comments](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/comments/service/CommentService.java): `src/main/java/com/gbsw/snapy/domain/comments/service/CommentService.java`
- [Guestbooks](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/guestbook/service/GuestBookService.java): `src/main/java/com/gbsw/snapy/domain/guestbook/service/GuestBookService.java`
- [Contact discovery](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/contacts/service/ContactsService.java): `src/main/java/com/gbsw/snapy/domain/contacts/service/ContactsService.java`

### User and safety

- [User profiles](https://github.com/2026-snapy/server/tree/main/src/main/java/com/gbsw/snapy/domain/users/service): `src/main/java/com/gbsw/snapy/domain/users/service`
- [User records](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/users/repository/UserRepository.java): `src/main/java/com/gbsw/snapy/domain/users/repository/UserRepository.java`
- [Privacy settings](https://github.com/2026-snapy/server/tree/main/src/main/java/com/gbsw/snapy/domain/settings/service): `src/main/java/com/gbsw/snapy/domain/settings/service`
- [User settings](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/settings/repository/UserSettingRepository.java): `src/main/java/com/gbsw/snapy/domain/settings/repository/UserSettingRepository.java`
- [User blocking](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/blocks/service/UserBlockService.java): `src/main/java/com/gbsw/snapy/domain/blocks/service/UserBlockService.java`

### Notifications and media

- [Notifications](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/notifications/service/NotificationService.java): `src/main/java/com/gbsw/snapy/domain/notifications/service/NotificationService.java`
- [Device tokens](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/domain/device/service/DeviceTokenService.java): `src/main/java/com/gbsw/snapy/domain/device/service/DeviceTokenService.java`
- [Push delivery](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/infra/push/PushNotificationService.java): `src/main/java/com/gbsw/snapy/infra/push/PushNotificationService.java`
- [Apple push](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/infra/apns/ApnsPushService.java): `src/main/java/com/gbsw/snapy/infra/apns/ApnsPushService.java`
- [Firebase push](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/infra/fcm/FcmPushService.java): `src/main/java/com/gbsw/snapy/infra/fcm/FcmPushService.java`
- [Media storage](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/infra/s3/S3Service.java): `src/main/java/com/gbsw/snapy/infra/s3/S3Service.java`
- [S3 uploader](https://github.com/2026-snapy/server/blob/main/src/main/java/com/gbsw/snapy/infra/s3/S3Uploader.java): `src/main/java/com/gbsw/snapy/infra/s3/S3Uploader.java`

### Other components

- **Mobile clients**
- **SMS provider**

## Connections

- OAuth and auth → User records: reads/writes (evidence: `src/main/java/com/gbsw/snapy/domain/auth/service/AppleOAuthService.java`)
- OAuth and auth → User settings: creates settings (evidence: `src/main/java/com/gbsw/snapy/domain/auth/service/AppleOAuthService.java`)
- OAuth and auth → Mobile clients: returns login result
- Phone verification → SMS provider: sends codes (evidence: `src/main/java/com/gbsw/snapy/domain/phone/service/PhoneVerificationService.java`)
- Phone verification → User records: checks users (evidence: `src/main/java/com/gbsw/snapy/domain/phone/service/PhoneVerificationService.java`)
- Album browsing → Album records: reads albums (evidence: `src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java`)
- Album browsing → User settings: checks visibility (evidence: `src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java`)
- Album browsing → Friend records: checks friendship (evidence: `src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java`)
- Album browsing → User records: loads users (evidence: `src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java`)
- Friend network → Friend records: reads/writes (evidence: `src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java`)
- Friend network → User records: loads users (evidence: `src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java`)
- Friend network → User blocking: checks blocks (evidence: `src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java`)
- Media storage → S3 uploader: uploads/deletes (evidence: `src/main/java/com/gbsw/snapy/infra/s3/S3Service.java`)
- Apple push → Device tokens: looks up tokens (evidence: `src/main/java/com/gbsw/snapy/infra/apns/ApnsPushService.java`)
- Firebase push → Device tokens: looks up tokens (evidence: `src/main/java/com/gbsw/snapy/infra/fcm/FcmPushService.java`)
- Push delivery → Apple push: dispatches (evidence: `src/main/java/com/gbsw/snapy/infra/push/PushNotificationService.java`)
- Push delivery → Firebase push: dispatches (evidence: `src/main/java/com/gbsw/snapy/infra/push/PushNotificationService.java`)
