How correctroadh/opentickly works
OpenTickly is a private-first, self-hostable time-tracking product with a web app and Go backend. The main user workflow is recording and managing time entries, then reviewing time through reports; the product also supports project/task organization, imports and exports, identity and workspace administration, billing, governance, and webhooks. The sampled source confirms parts of the web query layer and update worker. Many backend connections are inferred from the product layout rather than inspected source, so those links are marked dashed and uncited.
Main entry points: web-shell.ts Query facade · bootstrap.tsx Web interface · ConnectedListView.tsx Time entry UI · handler_time_entries.go Tracking API
Components 23
Web app
- Web interface
apps/website/src/app/bootstrap.tsx - Query facade
apps/website/src/shared/query/web-shell.ts - Session queries
apps/website/src/shared/query/web-shell-session.ts - Time-entry queries
apps/website/src/shared/query/web-shell-time-entries.ts - Project queries
apps/website/src/shared/query/web-shell-projects.ts - Workspace queries
apps/website/src/shared/query/web-shell-workspaces.ts - Organization queries
apps/website/src/shared/query/web-shell-organizations.ts
Tracking and reports
- Time entry UI
apps/website/src/features/tracking/ConnectedListView.tsx - Tracking API
apps/backend/internal/tracking/transport/http/public-api/handler_time_entries.go - Tracking services
apps/backend/internal/tracking/application/service_time_entries.go - Reports
apps/backend/internal/reports/application/service.go
Workspace services
- Projects and tasks
apps/backend/internal/catalog/application/service_projects.go - Tenants and workspaces
apps/backend/internal/tenant/application/service.go - Membership
apps/backend/internal/membership/application/service.go - Identity and SSO
apps/backend/internal/identity/application/service.go
Integrations and operations
- Billing
apps/backend/internal/billing/application/invoice_service.go - Governance
apps/backend/internal/governance/application/service.go - Import and export
apps/backend/internal/importing/application/service.go - Webhooks
apps/backend/internal/webhooks/application/service.go - PostgreSQL
- Update service
apps/update-worker/src/index.ts
Other components
- User
- GitHub releases
Connections 26
- User → Web interface: uses
README.md - Web interface → Time entry UI: records time
README.md - Time entry UI → Query facade: requests data
- Query facade → Time-entry queries: re-exports
apps/website/src/shared/query/web-shell.ts - Query facade → Session queries: re-exports
apps/website/src/shared/query/web-shell.ts - Query facade → Project queries: re-exports
apps/website/src/shared/query/web-shell.ts - Query facade → Workspace queries: re-exports
apps/website/src/shared/query/web-shell.ts - Query facade → Organization queries: re-exports
apps/website/src/shared/query/web-shell.ts - Web interface → Query facade: uses queries
- Query facade → Tracking API: calls API
- Tracking API → Tracking services: delegates
- Tracking services → PostgreSQL: reads and writes
- User → Projects and tasks: organizes work
README.md - User → Reports: reviews time
README.md - User → Import and export: moves data
README.md - User → Identity and SSO: signs in
- Tenants and workspaces → PostgreSQL: persists workspace
- Membership → PostgreSQL: persists membership
- Identity and SSO → PostgreSQL: persists identity
- Projects and tasks → PostgreSQL: persists catalog
- Reports → PostgreSQL: reads reports
- Billing → PostgreSQL: persists billing
- Governance → PostgreSQL: persists audit
- Import and export → PostgreSQL: imports data
- Webhooks → PostgreSQL: persists hooks
- Update service → GitHub releases: fetches releases
apps/update-worker/src/index.ts