Jobs

Active contributors: Sergio Castaño Arteaga, Cintia Sánchez García, Sako Mammadov

Purpose

The jobs feature provides a community jobs board where group organizers can post job listings. A scheduled background worker (job_discovery) automatically discovers and imports job postings from user-approved external sources via the You.com search API.

Directory layout

ocg-server/src/
├── handlers/site/jobs.rs                # public jobs board handler
├── handlers/dashboard/jobs.rs           # dashboard: post, edit, delete jobs
├── services/job_discovery.rs            # You.com-powered scheduled and on-demand discovery
├── db/jobs.rs                           # DB queries: get_jobs, add_job, update_job, delete_job
├── templates/site/                      # MiniJinja template structs for jobs pages
└── types/jobs.rs                        # JobInput, Job, and related types

Key abstractions

Abstraction	File	Description
`DBJobs`	`ocg-server/src/db/jobs.rs`	Trait: `get_jobs`, `add_job`, `update_job`, `delete_job`, `get_job_sources`
`ManualJobDiscovery`	`ocg-server/src/services/job_discovery.rs`	Trigger an on-demand user-scoped discovery run from the dashboard
`JobInput`	`ocg-server/src/types/jobs.rs`	Validated input struct for creating/updating a job listing

How it works

graph TD
    Organizer -->|Dashboard| PostJob[Post/edit job listing]
    PostJob -->|DB: add_job / update_job| DB[(PostgreSQL)]

    JobDiscoveryWorker -->|daily schedule| YouCom[You.com search API]
    YouCom -->|job results| Validate[garde validation]
    Validate -->|DB: add_job| DB

    JobsBoard -->|DB: get_jobs| DB
    JobsBoard -->|rendered HTML| PublicUser

Manual job posting

Group organizers post jobs through the dashboard at /dashboard/alliance/:alliance_id/group/:group_id/jobs. Fields are validated using the garde crate (JobInput) before being written to the database.

Global job discovery

services/job_discovery.rs runs a daily background worker that:

Queries the database for user-approved job source configurations (get_job_sources).
Calls the You.com search API for each source query.
Validates each result against JobInput using garde.
Fetches approved candidate pages and prefers structured JobPosting data over search snippets.
Stores valid jobs as drafts in a review queue; the owner publishes or rejects each candidate.

A ManualJobDiscovery handle is injected into dashboard handlers so authorized users can trigger an immediate discovery run without waiting for the next scheduled cycle.

Importing discovery sources

The discovery dashboard accepts up to 1,000 source URLs at a time. Paste one URL per line or a comma-separated list; entries without a scheme are normalized to https://. Duplicate URLs in an import are ignored and only HTTP(S) sources accepted by the existing source validation are stored.

The editable enterprise-careers reference catalog and its provenance are in database/data/discovery/. Catalog coverage only identifies domains to search; it does not guarantee that a run finds or creates a job draft.

Public jobs board

The /jobs page is handled by ocg-server/src/handlers/site/jobs.rs. It queries DBJobs::get_jobs and renders a paginated list of active listings.

Integration points

Groups and alliances — jobs are scoped to groups; group admins manage them from the dashboard.
MCP server — goup_search_jobs tool searches the jobs API.
You.com search API via ocg-server/src/integrations/you_com.rs.

Entry points for modification

Add a job field: extend JobInput in ocg-server/src/types/jobs.rs, update DBJobs in ocg-server/src/db/jobs.rs, and add a migration.
Change discovery schedule: update the sleep interval in ocg-server/src/services/job_discovery.rs.
Add a new job source: configure a source record in the database; the worker picks it up automatically.

GOUP documentation