How bcgov/cydb-submissions works
CYDB Submissions is a SvelteKit application for collecting public submissions and supporting staff review. The principal workflow validates and stores a form submission and attachments, then exposes searchable staff lists and read-only submission views. Staff authentication, role-gated administration, CHEFS import, OCR processing, and operational probes are additional capabilities. The graph follows relationships supported by the README or supplied source excerpts and SOURCE INDEX; unsampled paths are represented only where their role is documented.
Main entry points: submissions.ts Submission persistence · schema.ts SQLite data · ingest.ts CHEFS ingestion · process-job.ts OCR job processor
Components 26
Submission intake
- Public form
src/routes/+page.svelte - Form schema
src/lib/form/schema.ts - Submission endpoint
archive/public-form/+page.server.ts - Submission persistence
src/lib/server/submissions.ts - Attachment storage
src/lib/server/storage.ts
Staff access and review
- Authentication
src/lib/server/auth-options.ts - Staff routes
src/routes/submissions/+page.server.ts - Search and sort
src/lib/server/search/query.ts - Submission viewer
src/routes/submissions/[uuid]/+page.server.ts - Attachment access
src/routes/attachments/[id]/+server.ts - Administration
src/routes/admin/+page.server.ts - CHEFS settings
src/routes/admin/chefs/+page.server.ts
Import and processing
- CHEFS poller
src/lib/server/chefs/poller.ts - CHEFS API client
src/lib/server/chefs/client.ts - CHEFS mapper
src/lib/server/chefs/mapper.ts - CHEFS ingestion
src/lib/server/chefs/ingest.ts - OCR job queue
src/lib/server/ocr/enqueue.ts - OCR worker
src/lib/server/ocr/worker.ts - OCR job processor
src/lib/server/ocr/process-job.ts - OCR provider
src/lib/server/ocr/select-provider.ts - Search indexing
src/lib/server/search/indexer.ts
Shared platform
- SQLite data
src/lib/server/db/schema.ts - Health probes
src/routes/healthz/+server.ts - Audit logging
src/lib/server/audit.ts
Other components
- Staff member
- BC Gov SSO
Connections 28
- Public form → Submission endpoint: posts form
- Submission endpoint → Form schema: validates with
- Submission endpoint → Submission persistence: persists submission
- Submission persistence → SQLite data: writes records
src/lib/server/submissions.ts - Submission persistence → Attachment storage: stores files
src/lib/server/submissions.ts - Submission persistence → OCR job queue: enqueues attachments
src/lib/server/submissions.ts - Staff member → Authentication: signs in
- Authentication → BC Gov SSO: authenticates with
src/lib/server/auth-options.ts - Staff routes → Search and sort: queries submissions
- Search and sort → SQLite data: reads records
src/lib/server/search/query.ts - Staff routes → Submission viewer: opens submission
- Submission viewer → SQLite data: loads details
- Submission viewer → Attachment access: previews attachments
- Attachment access → Attachment storage: reads files
- Administration → CHEFS settings: configures import
- CHEFS poller → CHEFS API client: fetches exports
- CHEFS poller → CHEFS mapper: maps submissions
- CHEFS poller → CHEFS ingestion: ingests results
- CHEFS ingestion → CHEFS API client: downloads files
src/lib/server/chefs/ingest.ts - CHEFS ingestion → Submission persistence: writes submissions
src/lib/server/chefs/ingest.ts - CHEFS ingestion → Attachment storage: saves attachments
src/lib/server/chefs/ingest.ts - OCR worker → OCR job queue: leases jobs
src/lib/server/ocr/worker.ts - OCR worker → OCR job processor: processes jobs
src/lib/server/ocr/worker.ts - OCR job processor → OCR provider: analyzes documents
- OCR job processor → SQLite data: stores OCR results
src/lib/server/ocr/process-job.ts - Health probes → SQLite data: checks readiness
- Staff routes → Audit logging: logs actions
- OCR job processor → Search indexing: updates search index