How nnavyy/automation-vacancy-finder works
Nanda AI Job Assistant is a multi-user HH.ru job-search and application-tracking product. Users configure search profiles, review vacancies evaluated against their preferences, save or apply to matches, and track outcomes; collection can also notify them through Telegram. Separate capabilities cover company-contact research and outreach, HH.ru negotiation synchronization, and analytics. The collection pipeline and selected API handlers are sampled; several documented subsystems are represented by their exact route or library paths, but their internal calls are not inferred from filenames alone.
Main entry points: collectionPipeline.ts Collection pipeline · db.ts Application database · route.ts Manual analysis API · feedbackLearning.ts Feedback learning
Components 27
Job Search Experience
- Dashboard
src/app/dashboard/page.tsx - Vacancy views
src/app/dashboard/vacancies/page.tsx - Profile settings
src/app/dashboard/settings/page.tsx - Analytics
src/app/dashboard/analytics/page.tsx - Vacancy API
src/app/api/vacancies/route.ts - Settings API
src/app/api/settings/route.ts - Search profiles
src/app/api/profiles/route.ts
Collection & Evaluation
- Collection pipeline
src/lib/collectionPipeline.ts - HH vacancy clients
src/lib/hhPublicVacancyClient.ts - Rule screening
src/lib/ruleFilter.ts - Feedback learning
src/lib/feedbackLearning.ts - AI vacancy analysis
src/lib/aiAnalyzer.ts - Rule scoring
src/lib/scoring.ts - Manual analysis API
src/app/api/vacancies/analyze/route.ts
Application Workflow
- Vacancy actions
src/app/api/vacancies/[id]/route.ts - Cover letter generation
src/app/api/vacancies/[id]/regenerate-letter/route.ts - Company contact research
src/lib/companyIntel.ts - Company Intel API
src/app/api/company-intel/search/route.ts - Outreach email API
src/app/api/company-intel/generate-email/route.ts
External Integrations
- Telegram notifications
src/lib/telegram.ts - Telegram actions
src/app/api/telegram/webhook/route.ts - HH negotiation sync
src/app/api/cron/sync-negotiations/route.ts - HH.ru
- AI providers
src/lib/aiProviderRouter.ts - Telegram
- Application database
src/lib/db.ts
Other components
- Job seeker
Connections 29
- Job seeker → Dashboard: reviews matches
- Job seeker → Vacancy views: reviews vacancies
- Job seeker → Profile settings: configures profile
- Job seeker → Analytics: tracks outcomes
- Collection pipeline → Application database: reads preferences; stores vacancies
- Collection pipeline → HH vacancy clients: collects listings
- Collection pipeline → Rule screening: screens vacancies
- Collection pipeline → Feedback learning: gets similar feedback
- Collection pipeline → AI vacancy analysis: analyzes vacancies
- Collection pipeline → Telegram notifications: sends match alerts
- Collection pipeline → Telegram: notifies
- Manual analysis API → Application database: loads and saves analysis
- Manual analysis API → Feedback learning: gets similar feedback
- Manual analysis API → AI vacancy analysis: analyzes vacancy
- Manual analysis API → Rule scoring: calculates rule score
- Vacancy API → Application database: queries vacancies
- Settings API → Application database: reads and writes preferences
- Search profiles → Application database: manages profiles
- Cover letter generation → Application database: loads and updates letter
- Cover letter generation → Feedback learning: gets similar feedback
- Cover letter generation → AI providers: requests letter
- Outreach email API → Application database: reads resume
- Outreach email API → AI providers: generates outreach
- Telegram actions → Application database: reads vacancies; records feedback
- Telegram actions → Feedback learning: saves feedback
- Telegram actions → Telegram: answers updates
- Company Intel API → Company contact research: searches contacts
- HH negotiation sync → HH.ru: syncs negotiations
- Collection pipeline → AI providers: uses AI providers