How mohammedabusamra04/career-platform works
AI Career Platform is a Telegram job-alert service. Users set preferences and subscribe; scheduled or on-demand runs collect postings per subscriber, deduplicate them, analyze unique jobs once, score them against preferences, and notify users about qualifying jobs not previously sent. The graph includes the bot, HTTP and scheduler entry points, pipeline stages, source integrations, matching, notifications, and Redis-backed state. Relationships are limited to shown imports/calls or explicit README claims; several source implementations were not sampled.
Main entry points: job.pipeline.service.ts Job pipeline · services.ts Service wiring · matching.service.ts AI and rule matching · subscription.service.ts Subscription service
Components 23
Entry points
- Telegram bot
src/bot/bot.ts - Preference flow
src/bot/handlers/preferences.handler.ts - Subscription commands
src/bot/handlers/subscription.handler.ts - HTTP app
src/app.ts - Pipeline endpoint
src/modules/jobs/job.pipeline.route.ts - Notification scheduler
src/modules/notifications/job-notification.scheduler.ts - CLI trigger
src/scripts/run-pipeline.ts
Job collection
- Job pipeline
src/modules/jobs/job.pipeline.service.ts - Job collection
src/modules/jobs/job.collection.service.ts - Source manager
src/modules/jobs/sources/job-source.manager.ts - Job-board sources
src/modules/jobs/sources
Deduplication and matching
- Job deduplication
src/modules/deduplication/deduplication.service.ts - Fingerprinting
src/modules/deduplication/fingerprint.service.ts - AI and rule matching
src/modules/matching/matching.service.ts - Gemini provider
src/modules/matching/ai/gemini.provider.ts
Preferences and delivery
- Preference service
src/modules/preferences/preference.service.ts - Subscription service
src/modules/subscriptions/subscription.service.ts - Telegram notifications
src/modules/notifications/telegram/telegram-notification.service.ts
State and integrations
- Redis cache adapter
src/cache/redis.adapter.ts - Redis
src/config/redis.ts - Service wiring
src/config/services.ts
Other components
- Telegram user
- Pipeline caller
Connections 32
- Telegram user → Telegram bot: sends updates
- Telegram bot → Preference flow: registers handler
src/bot/bot.ts - Telegram bot → Subscription commands: registers handler
src/bot/bot.ts - Preference flow → Preference service: saves preferences
src/bot/handlers/preferences.handler.ts - Preference flow → Subscription service: subscribes user
src/bot/handlers/preferences.handler.ts - Subscription commands → Subscription service: manages subscription
src/bot/handlers/subscription.handler.ts - Pipeline caller → Pipeline endpoint: requests run
- HTTP app → Pipeline endpoint: mounts route
src/app.ts - Pipeline endpoint → Job pipeline: triggers run
src/modules/jobs/job.pipeline.route.ts - Notification scheduler → Job pipeline: runs pipeline
- CLI trigger → Job pipeline: runs pipeline
src/scripts/run-pipeline.ts - Job pipeline → Subscription service: loads subscribers
src/modules/jobs/job.pipeline.service.ts - Job pipeline → Preference service: loads criteria
- Job pipeline → Job collection: collects per user
src/modules/jobs/job.pipeline.service.ts - Job collection → Source manager: fetches jobs
- Source manager → Job-board sources: dispatches sources
src/modules/jobs/sources/job-source.manager.ts - Job pipeline → Job deduplication: deduplicates listings
src/modules/jobs/job.pipeline.service.ts - Job deduplication → Fingerprinting: creates fingerprints
src/modules/deduplication/deduplication.service.ts - Job pipeline → AI and rule matching: analyzes unique jobs
src/modules/jobs/job.pipeline.service.ts - Job pipeline → AI and rule matching: scores per user
src/modules/jobs/job.pipeline.service.ts - AI and rule matching → Gemini provider: analyzes jobs
src/config/services.ts - AI and rule matching → Redis cache adapter: caches analyses
src/modules/matching/matching.service.ts - Job pipeline → Telegram notifications: sends qualifying jobs
src/modules/jobs/job.pipeline.service.ts - Job pipeline → Redis cache adapter: checks sent log
src/modules/jobs/job.pipeline.service.ts - Preference service → Redis cache adapter: stores preferences
src/modules/preferences/preference.service.ts - Subscription service → Redis: stores subscriptions
src/modules/subscriptions/subscription.service.ts - Redis cache adapter → Redis: reads and writes
src/config/services.ts - Service wiring → Job collection: constructs service
src/config/services.ts - Service wiring → Source manager: registers sources
src/config/services.ts - Service wiring → AI and rule matching: constructs service
src/config/services.ts - Service wiring → Job pipeline: constructs service
src/config/services.ts - Service wiring → Telegram notifications: constructs service
src/config/services.ts