Skip to main content
Version: Sprint 1

Physical View

The Physical View describes the system's deployment architecture, infrastructure, and runtime environment.

Deployment Diagram - Production Architecture​

The production deployment on Vercel with external services.

Deployment Diagram - Build Pipeline​

The CI/CD and build process.

Infrastructure Diagram - Runtime Components​

Runtime components and their interactions.

Network Diagram - Request Flow​

How different types of requests are handled.

Container Diagram - Runtime Isolation​

How the application is packaged and isolated.

Technology Deployment Matrix​

ComponentTechnologyLocationPurpose
FrontendSolidJS + ViteVercel EdgeClient-side UI
SSRSolidStartVercel FunctionsServer rendering
APINitroVercel FunctionsBackend routes
AuthBetter-AuthVercel FunctionsAuthentication
DatabasePostgreSQLExternalUser/session storage
OAuthGitHub/GoogleExternalSocial login
CDNVercel EdgeGlobalStatic asset caching
BuildGitea ActionsSelf-hostedCI/CD pipeline

Environment Configuration​

Scaling Considerations​