Jobs — Track Your Application Pipeline
ES Reference: Phase 0 (INTOS-ES-P0-001) — Job CRUD and Lifecycle, Section 5
Overview
Jobs represent your target opportunities. Track each application through its lifecycle stages, link interview kits, manage notes, and monitor progress all in one place.
Screens in This Feature Area
1. Jobs List (/dashboard/jobs)
Paginated, filterable list of all your job targets.
Buttons & Actions:
| Button | Behavior |
|---|---|
| Add Job | Opens the job creation form |
| Job Card (click) | Opens job detail view |
| Filter by Status | Filter by application stage (e.g., Interviewing, Applied) |
2. Create Job (/dashboard/jobs/new)
Manual form for adding a new job target.
Buttons & Actions:
| Button | Behavior |
|---|---|
| Save Job | Persists new job with minimum company + role |
| Paste JD | Paste the full job description text |
| Cancel | Discard and return to job list |
Required Fields:
- Company name (minimum)
- Role title (minimum)
Optional Fields:
- Job description (text/pasted)
- Job URL
- Location
- Stage
- Priority
- Dates
- Notes
3. Job Detail/View (/dashboard/jobs/view)
Complete job detail with linked kits, notes, and stage management.
Buttons & Actions:
| Button | Behavior |
|---|---|
| Edit | Edit job metadata (company, role, JD, URL, location, stage, priority, dates, notes) |
| Archive | Soft-archive with dependency summary — associated kits remain, excluded by default |
| Restore | Restore archived job (revalidates owner/state) |
| Delete | Controlled hard delete — prevents orphaned artifacts |
| Change Stage | Move the job through its lifecycle |
| Create Kit | Pre-populate kit creation with this job (does not duplicate JD) |
| View Kit (1 kit) | Open the associated kit directly |
| View Kits (2+ kits) | Open filtered kit list for this job |
| Add Note | Append a note to the job timeline |
Job Lifecycle States
INTERESTED → PREPARING → APPLIED → SCREENING → INTERVIEWING
↓
OFFER
↓
ACCEPTED / REJECTED / WITHDRAWN
ON_HOLD (any stage)
Custom states are supported via canonical category + display label.
Data Validation Rules
| Operation | Validation |
|---|---|
| Create | Company and role minimum; authenticated owner; audit + analytics event |
| Read | Owner only; not-found does not disclose existence |
| Update | Optimistic conflict handling; audit trail |
| Archive | Dependency summary shown before action |
| Restore | Revalidate owner/state before restoring |
| Delete | Controlled retention/admin path only |
Related ES Requirements
| ID | Requirement |
|---|---|
| P0-E03 | Job lifecycle CRUD with archive/restore |
| P0-NAV-005 | Job cards with company, role, stage, kit status, context-aware action |
| P0-NAV-006 | Empty state directs to Create Job |
| AC-03 | Job and Kit CRUD, archive and restore work without data loss |
| AC-04 | Create/View Kit actions are driven by persisted relationships |