timothepoznanski/poznote

How timothepoznanski/poznote works

Poznote is a self-hosted, multi-user note-taking application. A user works with notes through the web interface and REST API; note operations use per-user data and can involve attachments, activity logging, and Git synchronization. The README also documents collaboration and integration capabilities such as workspaces, sharing, reminders, backups, offline use, AI, transcription, an MCP server, and a browser extension. The graph preserves these documented branches, but omits uncertain internal links where source excerpts do not establish the calls.

Components 26

User experience

Web application src/public/index.php
Note interface src/public/js/notes-manager.js
REST API src/public/api/v1/index.php

Notes and collaboration

Note operations src/api/v1/controllers/NotesController.php
Folder operations src/api/v1/controllers/FoldersController.php
Note loading src/note_loader.php
Markdown processing src/markdown_parser.php
Workspace features src/lib/workspaces.php
Activity logging src/ActivityLog.php

Identity and storage

Authentication src/auth.php
User data manager src/users/UserDataManager.php
Account database src/users/db_master.php
User data store src/db_connect.php
Attachment storage src/storage/AttachmentStorage.php
S3 client src/storage/S3Client.php

Integrations and automation

Git synchronization src/GitSync.php
S3 backups src/S3BackupService.php
Reminder delivery src/ReminderEmailService.php
SMTP mailer src/SmtpMailer.php
Webhook dispatch src/WebhookDispatcher.php
MCP server mcp-server/src/poznote_mcp/server.py
MCP API client mcp-server/src/poznote_mcp/client.py
URL saver extension poznote-url-saver/popup.js

Other components

Poznote user
S3-compatible storage
SMTP service

Connections 24

Poznote user → Web application: uses README.md
Web application → Note interface: presents
Note interface → REST API: requests
Poznote user → REST API: uses
REST API → Note operations: dispatches
Note operations → Note loading: loads src/api/v1/controllers/NotesController.php
Note operations → Markdown processing: uses src/api/v1/controllers/NotesController.php
Note operations → Git synchronization: invokes src/api/v1/controllers/NotesController.php
Note operations → Activity logging: logs src/api/v1/controllers/NotesController.php
REST API → Folder operations: dispatches
Folder operations → Note loading: loads src/api/v1/controllers/FoldersController.php
Authentication → Account database: uses src/auth.php
Authentication → User data manager: uses src/auth.php
User data manager → Attachment storage: uses src/storage/AttachmentStorage.php
Attachment storage → S3 client: creates src/storage/AttachmentStorage.php
S3 client → S3-compatible storage: accesses
User data manager → User data store: manages src/db_connect.php
Git synchronization → Attachment storage: uses src/GitSync.php
S3 backups → S3 client: uploads src/S3BackupService.php
S3 backups → Activity logging: logs src/S3BackupService.php
Reminder delivery → SMTP mailer: sends src/ReminderEmailService.php
SMTP mailer → SMTP service: delivers
MCP server → MCP API client: uses mcp-server/src/poznote_mcp/server.py
URL saver extension → REST API: saves URLs

Drawn by GitDiagram on October 4, 2026 from the repository's file tree, README and source files. Read as Markdown