How 2026-snapy/server works
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: AlbumQueryService.java Album browsing · UserRepository.java User records · service OAuth and auth · FriendService.java Friend network
Components 27
Identity and access
- OAuth and auth
src/main/java/com/gbsw/snapy/domain/auth/service - Phone verification
src/main/java/com/gbsw/snapy/domain/phone/service/PhoneVerificationService.java
Photo journaling
- Daily albums
src/main/java/com/gbsw/snapy/domain/albums/service - Album browsing
src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java - Album records
src/main/java/com/gbsw/snapy/domain/albums/repository/DailyAlbumRepository.java - Photo library
src/main/java/com/gbsw/snapy/domain/photos/service/PhotoService.java - Audio uploads
src/main/java/com/gbsw/snapy/domain/audios/service/AudioService.java
Social interactions
- Friend network
src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java - Friend records
src/main/java/com/gbsw/snapy/domain/friends/repository/FriendRepository.java - Social feed
src/main/java/com/gbsw/snapy/domain/feed/service/FeedService.java - Feed comments
src/main/java/com/gbsw/snapy/domain/comments/service/CommentService.java - Guestbooks
src/main/java/com/gbsw/snapy/domain/guestbook/service/GuestBookService.java - Contact discovery
src/main/java/com/gbsw/snapy/domain/contacts/service/ContactsService.java
User and safety
- User profiles
src/main/java/com/gbsw/snapy/domain/users/service - User records
src/main/java/com/gbsw/snapy/domain/users/repository/UserRepository.java - Privacy settings
src/main/java/com/gbsw/snapy/domain/settings/service - User settings
src/main/java/com/gbsw/snapy/domain/settings/repository/UserSettingRepository.java - User blocking
src/main/java/com/gbsw/snapy/domain/blocks/service/UserBlockService.java
Notifications and media
- Notifications
src/main/java/com/gbsw/snapy/domain/notifications/service/NotificationService.java - Device tokens
src/main/java/com/gbsw/snapy/domain/device/service/DeviceTokenService.java - Push delivery
src/main/java/com/gbsw/snapy/infra/push/PushNotificationService.java - Apple push
src/main/java/com/gbsw/snapy/infra/apns/ApnsPushService.java - Firebase push
src/main/java/com/gbsw/snapy/infra/fcm/FcmPushService.java - Media storage
src/main/java/com/gbsw/snapy/infra/s3/S3Service.java - S3 uploader
src/main/java/com/gbsw/snapy/infra/s3/S3Uploader.java
Other components
- Mobile clients
- SMS provider
Connections 17
- OAuth and auth → User records: reads/writes
src/main/java/com/gbsw/snapy/domain/auth/service/AppleOAuthService.java - OAuth and auth → User settings: creates settings
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
src/main/java/com/gbsw/snapy/domain/phone/service/PhoneVerificationService.java - Phone verification → User records: checks users
src/main/java/com/gbsw/snapy/domain/phone/service/PhoneVerificationService.java - Album browsing → Album records: reads albums
src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java - Album browsing → User settings: checks visibility
src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java - Album browsing → Friend records: checks friendship
src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java - Album browsing → User records: loads users
src/main/java/com/gbsw/snapy/domain/albums/service/AlbumQueryService.java - Friend network → Friend records: reads/writes
src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java - Friend network → User records: loads users
src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java - Friend network → User blocking: checks blocks
src/main/java/com/gbsw/snapy/domain/friends/service/FriendService.java - Media storage → S3 uploader: uploads/deletes
src/main/java/com/gbsw/snapy/infra/s3/S3Service.java - Apple push → Device tokens: looks up tokens
src/main/java/com/gbsw/snapy/infra/apns/ApnsPushService.java - Firebase push → Device tokens: looks up tokens
src/main/java/com/gbsw/snapy/infra/fcm/FcmPushService.java - Push delivery → Apple push: dispatches
src/main/java/com/gbsw/snapy/infra/push/PushNotificationService.java - Push delivery → Firebase push: dispatches
src/main/java/com/gbsw/snapy/infra/push/PushNotificationService.java