How yatsenkoyura/netsanctum works
NetSanctum is a self-hosted modular web platform: the owner enters through the web application, which discovers and mounts enabled module routers; each module then serves its own application behavior using shared infrastructure. The README documents module discovery and shared services, while sampled source confirms several specific module-to-service relationships. Some listed product modules are represented at their directory paths because their implementation files were not sampled; their internal flows are therefore not asserted.
Main entry points: modules.py Module registry · main.py Web application · music Music library · vault Encrypted Vault
Components 24
Application runtime
- Web application
app/main.py
Module framework
- Module registry
app/core/modules.py - Module contracts
app/core/module_types.py
Shared services
- Authentication
app/core/security.py - Database sessions
app/core/database.py - Settings service
app/modules/system/settings/service.py - Object storage
app/core/storage.py - Template rendering
app/core/templates.py - Background tasks
app/core/task_dispatch.py - Offline packages
app/core/packages_router.py - Browser runtime client
app/core/browser_client.py
Product modules
- AllLib library
app/modules/alllib - Music library
app/modules/music - Encrypted Vault
app/modules/vault - Tabletop games
app/modules/tabletop_games - Video Archiver
app/modules/video_archiver - YouTube
app/modules/youtube - Planner
app/modules/planner - Search
app/modules/search - Scoped sharing
app/modules/system/sharing
Assistant and automation
- Miku assistant
app/modules/miku/router.py - Agent engine
app/core/agent/engine.py - Agent client
app/core/agent_client.py
Other components
- Owner
Connections 30
- Owner → Web application: uses
README.md - Web application → Module registry: discovers modules
README.md - Module registry → Module contracts: validates manifests
app/core/modules.py - Module registry → AllLib library: mounts enabled routers
README.md - Module registry → Music library: mounts enabled routers
README.md - Module registry → Encrypted Vault: mounts enabled routers
README.md - Module registry → Tabletop games: mounts enabled routers
README.md - Module registry → Video Archiver: mounts enabled routers
README.md - Module registry → YouTube: mounts enabled routers
README.md - Module registry → Planner: mounts enabled routers
README.md - Module registry → Search: mounts enabled routers
README.md - Module registry → Scoped sharing: mounts enabled routers
README.md - Module registry → Miku assistant: mounts enabled routers
README.md - Web application → Authentication: uses authentication
app/main.py - Web application → Database sessions: opens sessions
app/main.py - Web application → Settings service: seeds settings
app/main.py - Module registry → Template rendering: registers template dirs
app/core/templates.py - Miku assistant → Agent client: requests agent turns
app/modules/miku/router.py - Agent client → Agent engine: calls runtime engine
app/core/agent_client.py - Music library → Browser runtime client: uses browser client
app/modules/music/router.py - YouTube → Browser runtime client: uses browser client
app/modules/youtube/services.py - AllLib library → Object storage: uses storage
app/modules/alllib/router.py - Encrypted Vault → Object storage: uses storage
app/modules/vault/router.py - Tabletop games → Database sessions: uses sessions
app/modules/tabletop_games/router.py - Video Archiver → Object storage: uses storage
app/modules/video_archiver/router.py - Miku assistant → Database sessions: uses sessions
app/modules/miku/router.py - Music library → Background tasks: dispatches tasks
app/modules/music/router.py - Encrypted Vault → Background tasks: dispatches tasks
app/modules/vault/router.py - Video Archiver → Browser runtime client: uses browser client
app/modules/video_archiver/router.py - Web application → Offline packages: mounts package routes
app/core/packages_router.py