Architecture
System Context
The system is Próx OS, a cloud-first personal intelligence OS hosted at https://prox-os.com.
Context
The system is Próx OS, a cloud-first personal intelligence OS hosted at https://prox-os.com.
It should be accessible as a normal website while internally behaving like a browser-based OS Shell for apps, templates, Spaces, data sources, AI context, and cloud-first workflows.
Main Actors
Owner
The human maintainer and first user.
Responsibilities:
- Defines architecture boundaries
- Reviews AI-generated patches
- Owns production secrets
- Approves database and infrastructure changes
Visitor
A public visitor to https://prox-os.com.
May access:
- Public OS Shell surface
- Public apps
- Public datasets or pages
Authenticated User Future
A future logged-in user.
May access:
- Private windows
- Personal dashboards
- Saved app state
- Data-backed apps
AI Agent
A coding or operational agent such as Codex.
May access:
- Repository files
- AI-readable docs
- Local commands with approval
Must not access:
- Production secrets
- Production database writes
- External systems without explicit permission
External Systems
- Cloudflare Pages for frontend deployment
- Cloudflare Workers for API boundary
- Cloudflare R2 for object storage
- Neon PostgreSQL for primary database
- GitHub for version control
- RSS feeds for information radar and knowledge inbox workflows
- Notion / Airtable-style cloud data sources for read-only connector exploration
- NocoDB or similar tools for human data administration
- Future MCP clients for AI integration