How monicahq/monica works
Monica is a self-hosted personal relationship manager for recording information about family and friends. Users manage contacts and their many details, organize them in shared vaults, and track interactions, reminders, tasks, and diary entries. The sampled contact controller delegates contact operations to services; the broader domain directories also cover these README-documented features. The graph reflects that documented product scope, while edges are limited to relationships visible in the excerpts or source index; several feature implementations were not sampled.
Main entry points: Contact.php Contact record · Services Contact operations · Vault.php Vault · ContactController.php Contact workflow
Components 27
Web and identity
- Web controller
app/Http/Controllers/Controller.php - Social sign-in
app/Http/Controllers/Auth/SocialiteCallbackController.php
Contact records
- Contact workflow
app/Domains/Contact/ManageContact/Web/Controllers/ContactController.php - Contact operations
app/Domains/Contact/ManageContact/Services - Contact record
app/Models/Contact.php - Contact groups
app/Models/Group.php
Life tracking
- Interaction feed
app/Models/ContactFeedItem.php - Reminders
app/Domains/Contact/ManageReminders - Tasks
app/Domains/Contact/ManageTasks - Diary
app/Domains/Vault/ManageJournals/Web/Controllers/PostController.php - Photos and files
app/Domains/Contact/ManageDocuments/Services/UploadFile.php - File metadata
app/Models/File.php
Vaults and settings
- Account
app/Models/Account.php - User
app/Models/User.php - Vault
app/Models/Vault.php - Vault overview
app/Domains/Vault/ManageVault/Web/ViewHelpers/VaultIndexViewHelper.php - Personalization
app/Domains/Settings - Service validation
app/Services/BaseService.php - Service contract
app/Interfaces/ServiceInterface.php - Custom genders
app/Models/Gender.php - Pronouns
app/Models/Pronoun.php - Contact templates
app/Models/Template.php
DAV synchronization
- DAV client
app/Domains/Contact/DavClient/Services/Utils/Dav/DavClient.php - Address book sync
app/Domains/Contact/DavClient/Services/SynchronizeAddressBook.php - CardDAV and CalDAV
app/Domains/Contact/Dav/Web/Backend
Other components
- Monica user
- DAV server
Connections 30
- Monica user → Contact workflow: manages contacts
README.md - Contact workflow → Web controller: extends
app/Domains/Contact/ManageContact/Web/Controllers/ContactController.php - Contact workflow → Contact operations: calls
app/Domains/Contact/ManageContact/Web/Controllers/ContactController.php - Contact workflow → Contact record: reads
app/Domains/Contact/ManageContact/Web/Controllers/ContactController.php - Contact operations → Contact record: reads and writes
app/Domains/Contact/ManageContact/Services/CreateContact.php - Contact operations → Service validation: inherits
app/Domains/Contact/ManageContact/Services/CreateContact.php - Contact operations → Service contract: implements
app/Domains/Contact/ManageContact/Services/CreateContact.php - Contact operations → Interaction feed: creates feed item
app/Domains/Contact/ManageContact/Services/CreateContact.php - Contact record → Custom genders: references
app/Models/Contact.php - Contact record → Pronouns: references
app/Models/Contact.php - Contact record → Contact templates: references
app/Models/Contact.php - Contact record → Contact groups: relates to
app/Models/Contact.php - Monica user → Vault overview: organizes records
README.md - Vault overview → Vault: queries
app/Domains/Vault/ManageVault/Web/ViewHelpers/VaultIndexViewHelper.php - User → Vault: shares access
app/Models/User.php - Account → User: owns users
app/Models/Account.php - Account → Vault: owns vaults
app/Models/Account.php - Vault → Contact record: contains contacts
app/Models/Vault.php - Vault → File metadata: contains files
app/Models/Vault.php - Monica user → Reminders: sets reminders
README.md - Monica user → Tasks: manages tasks
README.md - Monica user → Diary: records diary
README.md - Monica user → Photos and files: uploads media
README.md - Photos and files → File metadata: creates metadata
app/Models/File.php - Monica user → Personalization: personalizes fields
README.md - Monica user → Social sign-in: signs in
app/Http/Controllers/Auth/SocialiteCallbackController.php - Social sign-in → User: authenticates
- Address book sync → DAV client: uses client
- DAV client → DAV server: exchanges DAV data
- CardDAV and CalDAV → Contact record: imports and exports
app/Models/Contact.php