hh-auto-reply/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

yarn dev          # run with hot reload (tsx watch)
yarn build        # compile TypeScript → dist/
yarn start        # run compiled output
yarn lint         # ESLint check
yarn lint:fix     # ESLint auto-fix
yarn db-view      # open Prisma Studio
yarn db-migrate   # create and apply a new migration (dev)
yarn db-deploy    # apply migrations in production

Architecture

The bot is a single-process Node.js app (ESM) that starts polling Telegram on launch. There is no HTTP server — all user interaction is via Telegram messages and inline keyboards.

Entry point: src/index.ts — registers handlers and starts polling.

Singletons:

• @bot → src/bot-singleton.ts — one TelegramBot instance shared across all modules. The Telegram token is hardcoded here (should be moved to .env).
• @prisma → src/prisma.ts — one PrismaClient instance.

Path aliases (defined in tsconfig.json):

• @bot → src/bot-singleton
• @prisma → src/prisma
• @/* → src/*

Feature module — src/hh/:

• bot-commands.ts — registers all HH-related Telegram handlers. Holds an in-memory state object (awaitingEmail, awaitingQuery, etc.) that tracks multi-step dialog flow. This state is not persisted and resets on restart.
• scraper.ts — Playwright (headless Chromium) automation against hh.ru. Key functions: login() (email + OTP flow, saves cookies to DB), getResume() (fetches resume text from hh.ru and upserts into Resume table), applyToJobs() (searches vacancies, generates AI cover letters per vacancy). The actual "Apply" button click is commented out — the function currently only generates letters without submitting.

AI — src/openai.ts: Uses Groq API (llama-3.3-70b-versatile) via the OpenAI-compatible SDK. The Groq API key is hardcoded (should be moved to .env).

Menu — src/bot-menu.ts: Renders the persistent reply keyboard and handles top-level button presses (💼 Меню, 👤 Debug).

Database (Prisma + SQLite)

Schema at prisma/schema.prisma, DB file at prisma/dev.db.

Model	Key fields
User	telegramId (BigInt, PK), session (hh.ru cookies as JSON string), hhEmail, prompt (AI system prompt)
Resume	id (hash from hh.ru URL), data (plain text), telegramId
Settings	telegramId (PK), searchQuery (default: "Vue"), maxApplies (default: 1)

telegramId is BigInt — when looking up by msg.chat.id (which is number), pass it directly; Prisma handles the coercion. But in index.ts it is explicitly cast with BigInt(chatId).

Environment

Required variables in .env:

DATABASE_URL="file:./dev.db"

OPENAI_API_KEY is in .env but unused — the active Groq key is hardcoded in src/openai.ts.