How vladislavsaltanov/paages works
Paages is a Blazor Server notes product with a separate JWT/PAT API over shared SQLite storage. The main user workflow is authenticated note and folder management in the web UI, backed by user-scoped services, with optional publication by public slug. The README documents rich editor, tree, tabs, and account capabilities; the supplied source excerpts do not expose their component-level wiring, so those branches are represented at subsystem level. Edges cite only documented or indexed relationships.
Main entry points: Paages.Api/Program.cs JWT and PAT API · Paages.Web/Program.cs Web host and cookie auth · PaagesDbContext.cs SQLite database · NoteService.cs Note and folder operations
Components 22
Web experience
- Blazor notes UI
Paages.Web - Folder tree and editor
Paages.Web - Tabs and navigation
Paages.Web/Services/NavigationController.cs - UI state
Paages.Web/Services/UIController.cs - Web host and cookie auth
Paages.Web/Program.cs
API access
- JWT and PAT API
Paages.Api/Program.cs - API authentication
Paages.Api/Auth/ApiTokenAuthHandler.cs - API endpoints
Paages.Api/Endpoints
Identity and accounts
- User accounts
Paages.Infrastructure/Services/UserAccountService.cs - Token lifecycle
Paages.Infrastructure/Services/AuthService.cs - Email account tokens
Paages.Infrastructure/Services/AccountTokenService.cs - SMTP email
Paages.Infrastructure/Email/SmtpEmailSender.cs - Google OAuth
Notes and publishing
- Note and folder operations
Paages.Infrastructure/Services/NoteService.cs - Tree change state
Paages.Infrastructure/Services/AppState.cs - Publications
Paages.Infrastructure/Services/PublicationService.cs
Shared persistence
- Domain model
Paages.Domain/Entities - SQLite database
Paages.Infrastructure/Data/PaagesDbContext.cs - SQLite configuration
Paages.Infrastructure/Data/DatabaseServiceCollectionExtensions.cs
Other components
- User
- API client
- Public note reader
Connections 33
- User → Blazor notes UI: uses
README.md - Blazor notes UI → Web host and cookie auth: served by
Paages.Web/Program.cs - Blazor notes UI → Folder tree and editor: edits notes
- Blazor notes UI → Tabs and navigation: navigates via
Paages.Web/Services/NavigationController.cs - Tabs and navigation → Note and folder operations: queries folders
Paages.Web/Services/NavigationController.cs - Tabs and navigation → UI state: expands folders
Paages.Web/Services/NavigationController.cs - Web host and cookie auth → User accounts: resolves Google user
Paages.Web/Program.cs - Web host and cookie auth → Email account tokens: handles account links
Paages.Web/Program.cs - Web host and cookie auth → SMTP email: registers sender
Paages.Web/Program.cs - Web host and cookie auth → Note and folder operations: registers service
Paages.Web/Program.cs - Web host and cookie auth → Publications: registers service
Paages.Web/Program.cs - Google OAuth → Web host and cookie auth: authenticates via
Paages.Web/Program.cs - API client → JWT and PAT API: calls
README.md - JWT and PAT API → API endpoints: maps endpoints
Paages.Api/Program.cs - JWT and PAT API → API authentication: configures
Paages.Api/Program.cs - JWT and PAT API → User accounts: registers service
Paages.Api/Program.cs - JWT and PAT API → Token lifecycle: registers service
Paages.Api/Program.cs - JWT and PAT API → Note and folder operations: registers service
Paages.Api/Program.cs - JWT and PAT API → Publications: registers service
Paages.Api/Program.cs - API authentication → JWT and PAT API: validates PAT
Paages.Api/Auth/ApiTokenAuthHandler.cs - API endpoints → Token lifecycle: handles auth
Paages.Api/Endpoints/AuthEndpoints.cs - Token lifecycle → User accounts: validates credentials
Paages.Infrastructure/Services/AuthService.cs - Note and folder operations → SQLite database: reads and writes
Paages.Infrastructure/Services/NoteService.cs - Note and folder operations → Tree change state: notifies tree changes
Paages.Infrastructure/Services/NoteService.cs - Publications → SQLite database: reads and writes
Paages.Infrastructure/Services/PublicationService.cs - User accounts → SQLite database: reads and writes
Paages.Infrastructure/Services/UserAccountService.cs - Token lifecycle → SQLite database: rotates refresh tokens
Paages.Infrastructure/Services/AuthService.cs - Email account tokens → SMTP email: sends account mail
Paages.Infrastructure/Services/AccountTokenService.cs - Public note reader → Publications: fetches by slug
- SQLite database → Domain model: stores entities
Paages.Infrastructure/Data/PaagesDbContext.cs - SQLite configuration → SQLite database: configures
Paages.Infrastructure/Data/DatabaseServiceCollectionExtensions.cs - Web host and cookie auth → SQLite configuration: configures database
Paages.Web/Program.cs - JWT and PAT API → SQLite configuration: configures database