init

CLAUDE.md

@@ -0,0 +1,60 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+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`.