How kovah/linkace works
LinkAce is a self-hosted bookmark archive. A user or API client enters through Laravel web/API routing, then controllers validate and dispatch bookmark, taxonomy, search, import/export, sharing, or administration actions. Repositories and Eloquent models persist results; asynchronous jobs monitor links and archive them externally. The tree and README establish additional OAuth, backup, RSS, and integration capabilities, but several route targets and implementations were not sampled, so those relationships are shown only where directory or class names provide sufficient evidence.
Main entry points: RouteServiceProvider.php Web API Routing · database.php Application Database · Repositories Domain Repositories · LinkController.php Link Management
Components 23
Application Entry
- Web API Routing
app/Providers/RouteServiceProvider.php
Bookmark Domain
- Link Management
app/Http/Controllers/Models/LinkController.php - REST API
app/Http/Controllers/API - Domain Repositories
app/Repositories - Application Database
config/database.php
Discovery Exchange
- Search Backend
app/Search/SearchBackendManager.php - Search Controllers
app/Http/Controllers/App/SearchController.php - Bookmark Import
app/Http/Controllers/App/ImportController.php - Import Job
app/Jobs/ImportLinkJob.php - Bookmark Export
app/Http/Controllers/App/ExportController.php - Public RSS Feeds
app/Http/Controllers/Guest/FeedController.php
Identity Administration
- User Registration
app/Actions/Fortify/CreateNewUser.php - OAuth Login
app/Http/Controllers/SocialiteController.php - User Administration
app/Http/Controllers/Admin/UserManagementController.php
Automation Integrations
- Link Monitoring
app/Console/Commands/CheckLinksCommand.php - Archive Job
app/Jobs/SaveLinkToWaybackmachine.php - Backup Storage
config/backup.php
Other components
- User
- API Client
- Linked Websites
- OAuth Provider
- Internet Archive
- S3-Compatible Storage
Connections 27
- User → Web API Routing: sends requests
- API Client → Web API Routing: calls API
- Web API Routing → Link Management: dispatches web
- Web API Routing → REST API: dispatches API
- Web API Routing → Search Controllers: dispatches search
- Web API Routing → Bookmark Import: dispatches import
- Web API Routing → Bookmark Export: dispatches export
- Web API Routing → Public RSS Feeds: dispatches feeds
- Link Management → Domain Repositories: writes bookmarks
- Link Management → Application Database: reads links
- REST API → Domain Repositories: updates models
- Domain Repositories → Application Database: persists data
- Search Controllers → Search Backend: runs search
- Search Backend → Application Database: queries links
- Bookmark Import → Import Job: queues imports
- Import Job → Domain Repositories: creates links
- Bookmark Export → Application Database: reads bookmarks
- Public RSS Feeds → Application Database: reads public data
- User → User Registration: registers account
- User Registration → Application Database: creates user
- User → OAuth Login: starts login
- OAuth Login → OAuth Provider: authenticates
- User Administration → Application Database: manages users
- Link Monitoring → Application Database: updates status
- Link Monitoring → Linked Websites: checks links
- Archive Job → Internet Archive: archives links
- Backup Storage → S3-Compatible Storage: stores backups