How bothomaje/clockedin works
clockedin is an Angular job-search workspace: users build a career profile, save opportunities, track applications, and prepare tailored documents for review. Its runtime also includes a separate job-ingestion worker and opportunity-discovery features. The README documents the broader workflow and AI capabilities; source evidence is sampled, so unverified subsystem links are omitted or marked dashed rather than inferred from naming alone.
Main entry points: ai.service.ts AI orchestration · app.routes.ts App routing · document-wizard-page.ts Document wizard · jobs-list-page.ts Job management
Components 26
Application shell
- App routing
src/app/app.routes.ts - Firebase services
src/app/core/firebase/firebase.ts
Identity and profile
- Account access
src/app/domains/identity/data/auth.service.ts - Career profile
src/app/domains/profile/data/profile.facade.ts - Profile repository
src/app/domains/profile/data/repositories/profile.repository.ts
Jobs and applications
- Job management
src/app/domains/jobs/feature/jobs-list-page/jobs-list-page.ts - Job repository
src/app/domains/jobs/data/repositories/job.repository.ts - Application workspace
src/app/shells/workspace/feature/application-detail-page/application-detail-page.ts
AI documents
- Document wizard
src/app/domains/documents/feature/document-wizard-page/document-wizard-page.ts - AI orchestration
src/app/domains/documents/data/ai/ai.service.ts - Evidence selection
src/app/domains/documents/data/ai/tasks/evidence-selection.task.ts - Provider contract
src/app/domains/documents/data/ai/ai-provider.ts - Gemini provider
src/app/domains/documents/data/ai/providers/firebase-gemini.provider.ts - Browser AI
src/app/domains/documents/data/ai/providers/webllm.provider.ts - Local analysis
src/app/domains/documents/data/ai/providers/transformers.provider.ts - Embedding model
src/app/domains/documents/data/ai/local/embedding-model.ts - CV validation
src/app/domains/documents/data/validation/cv-validator.ts - PDF rendering
src/app/domains/documents/data/pdf-service.ts - Saved document versions
src/app/domains/documents/data/repositories/document.repository.ts
Opportunity discovery
- Opportunity exploration
src/app/domains/recommendations/feature/explore-page/explore-page.ts - Job ingestion
workers/job-ingestion/src/ingestion/ingestion.service.ts - Firestore client
workers/job-ingestion/src/firestore/client.ts
Other components
- Job seeker
- Job source
- Cloud Firestore
- Google Gemini
Connections 30
- Job seeker → App routing: uses workspace
- App routing → Account access: routes to account
src/app/app.routes.ts - App routing → Job management: routes to jobs
src/app/app.routes.ts - App routing → Application workspace: routes to applications
src/app/app.routes.ts - App routing → Opportunity exploration: routes to explore
src/app/app.routes.ts - App routing → Document wizard: routes to documents
- Job seeker → Career profile: maintains profile
- Career profile → Profile repository: persists profile
- Job seeker → Job management: saves opportunities
- Job management → Job repository: stores job records
- Job seeker → Application workspace: tracks applications
- Application workspace → Document wizard: opens document builder
- Job seeker → Document wizard: reviews and edits
- Document wizard → AI orchestration: requests generation
- AI orchestration → Evidence selection: selects profile evidence
src/app/domains/documents/data/ai/ai.service.ts - AI orchestration → Provider contract: uses provider contract
src/app/domains/documents/data/ai/ai.service.ts - AI orchestration → Gemini provider: dispatches generation
src/app/domains/documents/data/ai/ai.service.ts - AI orchestration → Browser AI: dispatches generation
src/app/domains/documents/data/ai/ai.service.ts - AI orchestration → Local analysis: dispatches analysis
src/app/domains/documents/data/ai/ai.service.ts - Local analysis → Embedding model: uses embeddings
src/app/domains/documents/data/ai/providers/transformers.provider.ts - Gemini provider → Google Gemini: calls cloud model
- AI orchestration → CV validation: validates generated CV
src/app/domains/documents/data/ai/ai.service.ts - Document wizard → PDF rendering: renders PDF
- Document wizard → Saved document versions: stores versions
- Job seeker → Opportunity exploration: explores opportunities
- Job source → Job ingestion: provides job listings
workers/job-ingestion/src/ingestion/ingestion.service.ts - Job ingestion → Firestore client: writes accepted jobs
- Firestore client → Cloud Firestore: reads and writes
workers/job-ingestion/src/firestore/client.ts - Opportunity exploration → Cloud Firestore: loads recommendations
- Firebase services → Cloud Firestore: connects application