How its-dorra/dotion works
Dotion is a real-time collaborative workspace. Users enter through the web app, select a workspace, and work with pages; that workflow extends into editing, sharing, comments, search, and AI assistance. The server provides domain APIs and realtime coordination, while services apply authorization and domain logic over repositories and PostgreSQL. The README also documents file storage, background indexing and cleanup, and event/outbox processing. Several server-to-service and route-to-handler links are not visible in the excerpts, so those connections are omitted rather than inferred.
Main entry points: routes.ts Page API · route.tsx Web application · pages.service.ts Page service · search.service.ts Search and indexing
Components 26
Web workspace
- Web application
apps/web/src/routes/app/workspaces/$workspaceId/route.tsx - Page editing
apps/web/src/features/pages/api.ts - Workspace features
apps/web/src/features/workspaces/api.ts - Search interface
apps/web/src/features/search - AI assistant
apps/web/src/features/ai-assistant - Comments interface
apps/web/src/features/comments
Server domains
- HTTP application
apps/server/src/app.ts - Page API
apps/server/src/routes/workspaces/pages/routes.ts - Workspace API
apps/server/src/routes/workspaces/routes.ts - Assistant API
apps/server/src/routes/workspaces/assistant/routes.ts - Comments API
apps/server/src/routes/workspaces/pages/comments/routes.ts
Domain services
- Authorization
packages/services/src/authorization/authorization.service.ts - Page service
packages/services/src/pages.service.ts - Workspace service
packages/services/src/workspaces.service.ts - Search and indexing
packages/services/src/search.service.ts - Embedding generation
packages/services/src/embedding.service.ts - File storage
packages/services/src/storage.service.ts
Persistence and jobs
- PostgreSQL repositories
packages/db/src/repositories - Background queues
apps/server/src/queues/index.ts
Realtime and contracts
- Realtime coordination
apps/server/src/routes/workspaces/pages/durable-object.ts - Outbox and events
apps/server/src/events/index.ts - Shared schemas
packages/shared/src/events/index.ts
Other components
- Workspace user
- Cloudflare R2
- Neon PostgreSQL
- Cloudflare Queues
Connections 29
- Workspace user → Web application: uses
- Web application → Page editing: opens pages
apps/web/src/routes/app/workspaces/$workspaceId/route.tsx - Web application → Search interface: opens search
apps/web/src/routes/app/workspaces/$workspaceId/route.tsx - Web application → AI assistant: opens assistant
apps/web/src/routes/app/workspaces/$workspaceId/route.tsx - Page editing → Page API: requests pages
- Workspace features → Workspace API: requests workspaces
- Comments interface → Comments API: requests comments
- Search interface → HTTP application: searches workspace
- AI assistant → Assistant API: streams chat
apps/server/src/routes/workspaces/assistant/routes.ts - HTTP application → Page API: routes requests
- Page API → Page service: delegates page work
- Workspace API → Workspace service: delegates workspace work
- Assistant API → Search and indexing: retrieves context
- Page service → PostgreSQL repositories: accesses repositories
packages/services/src/pages.service.ts - Workspace service → PostgreSQL repositories: persists workspace data
- Search and indexing → PostgreSQL repositories: reads and indexes
packages/services/src/search.service.ts - Search and indexing → Embedding generation: generates vectors
packages/services/src/search.service.ts - Page service → Authorization: checks access
- Page API → Realtime coordination: coordinates collaboration
- Realtime coordination → Workspace user: syncs edits
- HTTP application → File storage: handles uploads
- File storage → Cloudflare R2: stores files
packages/services/src/storage.service.ts - Page service → Outbox and events: emits domain events
- Outbox and events → Cloudflare Queues: dispatches jobs
- Cloudflare Queues → Background queues: delivers jobs
- Background queues → Search and indexing: indexes pages
- Background queues → File storage: cleans assets
- PostgreSQL repositories → Neon PostgreSQL: queries
- Page API → Shared schemas: validates contracts
apps/server/src/routes/workspaces/pages/routes.ts