# wintermeyer/vutuv architecture

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

## Overview

vutuv is a federated professional social network: members create profiles, publish and discover posts, interact, and optionally federate with the Fediverse. Its web/API entry points lead into domain contexts for identity, social activity, organizations, and jobs; those domains persist state and integrate with external networks. The README also documents passwordless authentication, moderation, newsletters, exports, and agent-facing formats. The graph maps these documented capabilities to source paths in the tree; most internal call relationships are omitted because the sampled excerpts do not show them.

Main entry points: [`lib/vutuv_web/router.ex`](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/router.ex) (Phoenix routes), [`lib/vutuv/repo.ex`](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/repo.ex) (PostgreSQL repository), [`lib/vutuv/accounts.ex`](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/accounts.ex) (Accounts and profiles), [`lib/vutuv/posts.ex`](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/posts.ex) (Posts and reviews)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interfaces"]
  node_router["Phoenix routes<br/>[router.ex]"]
  node_settings["Member settings"]
  node_api["REST API<br/>[post_controller.ex]"]
  node_mastodon["Mastodon API"]
  node_fediverse_web["Fediverse endpoints"]
end

subgraph group_social["Social network"]
  node_accounts["Accounts and profiles<br/>[accounts.ex]"]
  node_posts["Posts and reviews<br/>[posts.ex]"]
  node_feed["Social feeds<br/>[social_feed.ex]"]
  node_activity["Social activity<br/>[activity.ex]"]
  node_messages["Direct messages<br/>[chat.ex]"]
  node_federation["ActivityPub federation<br/>[fediverse.ex]"]
end

subgraph group_work["Professional network"]
  node_organizations["Organizations<br/>[organizations.ex]"]
  node_jobs["Job board<br/>[jobs.ex]"]
  node_references["References and skills<br/>[references.ex]"]
  node_tags["Tags and discovery<br/>[tags.ex]"]
end

subgraph group_platform["Platform services"]
  node_moderation["Moderation<br/>[moderation.ex]"]
  node_newsletters["Newsletters<br/>[newsletters.ex]"]
  node_exports["Data export<br/>[export.ex]"]
  node_webhooks["Webhooks<br/>[webhooks.ex]"]
end

subgraph group_data["Persistence"]
  node_repo[("PostgreSQL repository<br/>[repo.ex]")]
end

node_member(("Member"))
node_external_networks(("Fediverse networks"))
node_ollama(("Ollama vision service"))
node_email(("Email service"))

node_member -->|"uses"| node_router
node_router -->|"routes settings"| node_settings
node_router -->|"routes REST"| node_api
node_router -->|"routes compatible API"| node_mastodon
node_router -->|"serves federation"| node_fediverse_web
node_member -->|"builds profile"| node_accounts
node_member -->|"publishes posts"| node_posts
node_member -->|"discovers posts"| node_feed
node_member -->|"interacts"| node_activity
node_member -->|"sends messages"| node_messages
node_member -->|"claims organization"| node_organizations
node_member -->|"uses job board"| node_jobs
node_member -->|"manages references"| node_references
node_member -->|"follows tags"| node_tags
node_federation -->|"federates"| node_external_networks
node_moderation -.->|"checks images"| node_ollama
node_newsletters -->|"delivers newsletter"| node_email
node_webhooks -.->|"notifies subscribers"| node_external_networks
node_posts -.->|"persists posts"| node_repo
node_accounts -.->|"persists accounts"| node_repo
node_organizations -.->|"persists organizations"| node_repo
node_jobs -.->|"persists listings"| node_repo

click node_router "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/router.ex"
click node_settings "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/controllers/settings_controller.ex"
click node_api "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/controllers/api_v2/post_controller.ex"
click node_mastodon "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/controllers/mastodon_api/status_controller.ex"
click node_fediverse_web "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/controllers/fediverse_controller.ex"
click node_accounts "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/accounts.ex"
click node_posts "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/posts.ex"
click node_feed "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/social_feed.ex"
click node_activity "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/activity.ex"
click node_messages "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/chat.ex"
click node_federation "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/fediverse.ex"
click node_organizations "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/organizations.ex"
click node_jobs "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/jobs.ex"
click node_references "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/references.ex"
click node_tags "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/tags.ex"
click node_moderation "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/moderation.ex"
click node_newsletters "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/newsletters.ex"
click node_exports "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/export.ex"
click node_webhooks "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/webhooks.ex"
click node_repo "https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/repo.ex"

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_router,node_settings,node_api,node_mastodon,node_fediverse_web toneBlue
class node_accounts,node_posts,node_feed,node_activity,node_messages,node_federation toneAmber
class node_organizations,node_jobs,node_references,node_tags toneMint
class node_moderation,node_newsletters,node_exports,node_webhooks toneRose
class node_repo,node_member,node_external_networks,node_ollama,node_email toneIndigo
```

## Components

### Web interfaces

- [Phoenix routes](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/router.ex): `lib/vutuv_web/router.ex`
- [Member settings](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/controllers/settings_controller.ex): `lib/vutuv_web/controllers/settings_controller.ex`
- [REST API](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/controllers/api_v2/post_controller.ex): `lib/vutuv_web/controllers/api_v2/post_controller.ex`
- [Mastodon API](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/controllers/mastodon_api/status_controller.ex): `lib/vutuv_web/controllers/mastodon_api/status_controller.ex`
- [Fediverse endpoints](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv_web/controllers/fediverse_controller.ex): `lib/vutuv_web/controllers/fediverse_controller.ex`

### Social network

- [Accounts and profiles](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/accounts.ex): `lib/vutuv/accounts.ex`
- [Posts and reviews](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/posts.ex): `lib/vutuv/posts.ex`
- [Social feeds](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/social_feed.ex): `lib/vutuv/social_feed.ex`
- [Social activity](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/activity.ex): `lib/vutuv/activity.ex`
- [Direct messages](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/chat.ex): `lib/vutuv/chat.ex`
- [ActivityPub federation](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/fediverse.ex): `lib/vutuv/fediverse.ex`

### Professional network

- [Organizations](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/organizations.ex): `lib/vutuv/organizations.ex`
- [Job board](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/jobs.ex): `lib/vutuv/jobs.ex`
- [References and skills](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/references.ex): `lib/vutuv/references.ex`
- [Tags and discovery](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/tags.ex): `lib/vutuv/tags.ex`

### Platform services

- [Moderation](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/moderation.ex): `lib/vutuv/moderation.ex`
- [Newsletters](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/newsletters.ex): `lib/vutuv/newsletters.ex`
- [Data export](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/export.ex): `lib/vutuv/export.ex`
- [Webhooks](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/webhooks.ex): `lib/vutuv/webhooks.ex`

### Persistence

- [PostgreSQL repository](https://github.com/wintermeyer/vutuv/blob/main/lib/vutuv/repo.ex): `lib/vutuv/repo.ex`

### Other components

- **Member**
- **Fediverse networks**
- **Ollama vision service**
- **Email service**

## Connections

- Member → Phoenix routes: uses (evidence: `README.md`)
- Phoenix routes → Member settings: routes settings (evidence: `README.md`)
- Phoenix routes → REST API: routes REST (evidence: `README.md`)
- Phoenix routes → Mastodon API: routes compatible API (evidence: `README.md`)
- Phoenix routes → Fediverse endpoints: serves federation (evidence: `README.md`)
- Member → Accounts and profiles: builds profile (evidence: `README.md`)
- Member → Posts and reviews: publishes posts (evidence: `README.md`)
- Member → Social feeds: discovers posts (evidence: `README.md`)
- Member → Social activity: interacts (evidence: `README.md`)
- Member → Direct messages: sends messages (evidence: `README.md`)
- Member → Organizations: claims organization (evidence: `README.md`)
- Member → Job board: uses job board (evidence: `README.md`)
- Member → References and skills: manages references (evidence: `README.md`)
- Member → Tags and discovery: follows tags (evidence: `README.md`)
- ActivityPub federation → Fediverse networks: federates (evidence: `README.md`)
- Moderation → Ollama vision service: checks images (evidence: `README.md`)
- Newsletters → Email service: delivers newsletter (evidence: `README.md`)
- Webhooks → Fediverse networks: notifies subscribers (evidence: `README.md`)
- Posts and reviews → PostgreSQL repository: persists posts
- Accounts and profiles → PostgreSQL repository: persists accounts
- Organizations → PostgreSQL repository: persists organizations
- Job board → PostgreSQL repository: persists listings
