How buechijonas/swissfy works
Swissfy is a social network with a Vue SPA and Django REST backend. Users authenticate through govex, then browse and publish posts, stories, reels and albums; interact through social connections, comments and encrypted chats; and receive notifications and achievements. Moderation and account administration provide distinct staff workflows. The README documents the backend app dependency direction and storage/authentication architecture; several implementation paths below are identified from the tree but were not sampled, so their internal call links are omitted.
Main entry points: urls.py Django REST API · posts.py Posts and stories · App.vue Swissfy SPA · chats Encrypted chats
Components 24
Web client
- Swissfy SPA
frontend/swissfy/src/App.vue - Page routing
frontend/swissfy/src/router/index.js - API clients
frontend/swissfy/src/api - Auth and events
frontend/swissfy/src/stores
Social features
- Posts and stories
backend/swissfy/posts/models/posts.py - Feed and audience
backend/swissfy/posts/models/feed.py - Albums and saved
backend/swissfy/posts/models/albums.py - Social connections
backend/swissfy/social/models.py - Encrypted chats
backend/swissfy/chats - Notifications
backend/swissfy/notifications - Achievements
backend/swissfy/achievements
Accounts and trust
- Accounts and OIDC
backend/swissfy/accounts - Role policy
backend/swissfy/accounts/roles.py - Reports and sanctions
backend/swissfy/moderation/models.py
Backend platform
- Django REST API
backend/main/urls.py - Live events
backend/commons/events.py - Content encryption
backend/commons/encryption.py - Encrypted media storage
backend/commons/storage.py - Shared model layer
backend/commons/models.py - Encryption backfill
backend/commons/backfill.py
Persistence
- PostgreSQL
- Media files
Other components
- Browser user
- govex / authentik
Connections 32
- Browser user → Swissfy SPA: uses
- Browser user → govex / authentik: signs in
- Swissfy SPA → Page routing: routes pages
frontend/swissfy/src/App.vue - Swissfy SPA → Auth and events: initializes and watches
frontend/swissfy/src/App.vue - Auth and events → Live events: connects to
- API clients → Django REST API: requests
- Django REST API → Accounts and OIDC: routes auth
- Django REST API → Posts and stories: routes content
- Django REST API → Social connections: routes connections
- Django REST API → Encrypted chats: routes chats
- Django REST API → Notifications: routes notifications
- Django REST API → Reports and sanctions: routes moderation
- Django REST API → PostgreSQL: reads and writes
- Accounts and OIDC → govex / authentik: exchanges identity
- Accounts and OIDC → Role policy: assigns roles
backend/swissfy/moderation/models.py - Reports and sanctions → Role policy: checks and changes
backend/swissfy/moderation/models.py - Reports and sanctions → Posts and stories: reviews content
- Posts and stories → Feed and audience: supports feed
- Posts and stories → Albums and saved: supports albums
- Posts and stories → Social connections: uses relationships
- Encrypted chats → Notifications: notifies
- Posts and stories → Notifications: notifies activity
- Achievements → PostgreSQL: persists progress
- Live events → PostgreSQL: listens for events
- Django REST API → Live events: publishes events
- Django REST API → Encrypted media storage: stores uploads
- Encrypted media storage → Content encryption: encrypts and decrypts
backend/commons/storage.py - Encrypted media storage → Media files: reads and writes
backend/commons/storage.py - Posts and stories → Content encryption: encrypts content
- Shared model layer → Content encryption: provides encrypted fields
- Encryption backfill → PostgreSQL: migrates stored rows
- Encrypted chats → PostgreSQL: stores ciphertext