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. Sprint 2 added an external file storage service for user documents.
Deployment Diagram - Build Pipeline
The CI/CD and build process.
Infrastructure Diagram - Runtime Components
Runtime components and their interactions. Sprint 2 added file storage communication.
Network Diagram - Request Flow
How different types of requests are handled. Sprint 2 added file upload/download request paths.
Container Diagram - Runtime Isolation
How the application is packaged and isolated.
Technology Deployment Matrix
| Component | Technology | Location | Purpose |
|---|---|---|---|
| Frontend | SolidJS + Vite | Vercel Edge | Client-side UI |
| SSR | SolidStart | Vercel Functions | Server rendering |
| API | Nitro | Vercel Functions | Backend routes |
| Auth | Better-Auth | Vercel Functions | Authentication |
| Database | PostgreSQL | External | Users, sessions, files, versions |
| OAuth | GitHub/Google | External | Social login |
| File Storage | Internal API | External | User document blobs |
| CDN | Vercel Edge | Global | Static asset caching |
| Build | Gitea Actions | Self-hosted | CI/CD pipeline |
| Testing | Vitest | CI/CD | Unit tests + coverage |
Environment Configuration
Sprint 2 added file storage configuration variables.
File Versioning Architecture
Sprint 2 introduced versioned file storage with automatic pruning.