Собери Telegram-бота консультаций на TypeScript (ESM, strict) + Telegraf v4 + Luxon + Zod. Без БД — память + JSON.
‼️ В src допускаются ТОЛЬКО .ts. Любые .js/.mjs/.cjs в src — ошибка, немедленно мигрируй в .ts.
parse_mode — только "HTML". Throttle — 300 мс на входящие. Никаких искусственных задержек/typing.
.ENV — создать строго ".env" и грузить dotenv.config({ path: '.env' }):
BOT_TOKEN=
ADMIN_ID=0
LOG_CHAT_ID=0
TIMEZONE=Europe/Moscow
LOCALE=ru-RU
CURRENCY=RUB
Если BOT_TOKEN пуст — выведи «BOT_TOKEN не задан в .env» и process.exit(1) БЕЗ стектрейса.
package.json — скрипты:
dev="tsx watch src/core/index.ts"
build="tsc"
start="node dist/core/index.js"
tsconfig — ESNext, strict, node resolution, resolveJsonModule, verbatimModuleSyntax, outDir=dist.
Структура .ts:
src/core/{index.ts,bot.ts,config.ts}
src/state/session.ts
src/logic/{slots.ts,booking.ts}
src/ui/{keyboards.ts,texts.ts}
src/utils/{time.ts,files.ts,html.ts}
data/{slots.json,bookings.json,messages.json,sessions.json}
Гарантированная генерация слотов
– Реализуй ensureSlots({minFree=12, seedDays=14, maxDays=28, hours=[11,15,19]}) в logic/slots.ts.
– Алгоритм:
nowTZ=DateTime.now().setZone(TIMEZONE).
Сгенерируй ISO-слоты на seedDays вперёд по hours, только > nowTZ, дедуп, сортировка.
Пометь занятые по bookings.json, оставь свободные.
Если свободных < minFree → добавляй дни партиями до maxDays, пока свободных ≥ minFree.
Сохрани в data/slots.json. На каждом запуске выполняй ensureSlots().
– В лог на старте вывести ровно одну строку:
📅 Slots ready: free=<N> total=<T> window=<firstDate>…<lastDate>
– Если после maxDays свободных по-прежнему 0 — добавь ещё один день (fallback) и обязательно создай хотя бы 3 слота завтра в 11:00/15:00/19:00.
Меню и «2 сообщения»
– setMyCommands: /start, /menu, /book, /my, /help.
– setChatMenuButton({ type:'commands' }).
– Сообщение A (статичное, НЕ редактировать):
«Привет! Я бот Аникеева Ивана, вайбкодера. Продаю его консультации по созданию ИТ-продуктов. Сайт – kursorai.ru, канал – https://t.me/kursorai»
– Сообщение B — «живой» экран. upsertLive(ctx, html, kb): editMessageText → при 400/403 sendMessage; запомни liveMsgId в сессии.
Флоу пользователя (хэппи-путь, всё в P1)
Главное меню (state=main)
– Текст: «🏠 Главное меню\nВыберите действие:»
– Кнопки: «🗓 Записаться», «🔍 Подробнее», «📌 Мои записи», «◀ Назад», «🏠 Меню».
Подробнее
– Показать messages.about_html (дефолт ниже) + CTA «🗓 Записаться».
Календарь (2 шага)
– Шаг A (state=pick_day): 7 ближайших дней, где есть ≥1 свободный слот. Кнопки day:YYYY-MM-DD + «← Неделя / Неделя →». Низ: «◀ Назад», «🏠 Меню».
– Шаг B (state=pick_time): 2–5 свободных слотов одного дня, без дублей, отсортированы. Кнопки time:. Низ: «← Назад к дням».
Контакт — отдельное сообщение C (sendMessage, не edit)
– Текст: «📞 Как с вами связаться?\nВыберите удобный способ ниже.»
– Кнопки:
• inline «Использовать @username» — если есть ctx.from.username → фиксируем contact.
• reply-кнопка { text:'Отправить телефон', request_contact:true, one_time_keyboard:true, resize_keyboard:true }.
• inline «Ввести другой контакт» — только тогда примем следующий text как контакт.
– bot.on('contact') — сохраняем phone_number (нормализуй +7/8), убираем клавиатуру remove_keyboard.
– Как только контакт получен — отредактируй C на «✅ Контакт получен: …», очисти кнопки, и сразу переход к «Запросу».
Запрос — отдельное сообщение D + одно напоминание 30с
– Текст: «✍️ Кратко опишите запрос на консультацию\nНапишите сообщение ниже. Если сложно — нажмите «Пропустить».»
– Кнопки: «Пропустить», «◀ Назад».
– state='awaiting_request'. Один setTimeout(30с) → «⏳ Жду ваш запрос…». Очисти на ввод/«Пропустить».
– После ввода/пропуска — редактируй D на «✅ Запрос получен» (кнопки убрать) и сразу показывай Подтверждение.
Подтверждение (state=confirm) — на «живом» экране
– Текст: «Проверьте данные\n📅 Дата: …\n🕐 Время: …\n📞 Контакт: …\n📝 Запрос: …»
– Кнопки: «✅ Подтвердить», «✖ Отмена», «◀ Назад», «🏠 Меню».
Создание брони (без админки, уведомим позже в P2)
– На «✅»: перечитай файлы; если слот занят → предложи 2–3 альтернативы; иначе:
• slot.taken=true;
• booking = {
id:booking_${Date.now()}_${ctx.from.id}, state:'pending',
userId:ctx.from.id, username:ctx.from.username||null,
chatId:ctx.chat?.id ?? ctx.from.id, contact, slotISO, summary, ts:Date.now()
};
• сохрани; пользователю отдельное подтверждение:
«✅ Запись создана\n<ДД.ММ, ЧЧ:ММ>\nЧто дальше: мы подтвердим время и пришлём ссылку.»
Кнопки: «🏠 Меню», «📌 Мои записи».
Мои записи
– /my и кнопка показывают ближайшую активную запись по userId (slotISO>now, !cancelledAt, state∈{'pending','confirmed'}).
– Кнопки: «Изменить время» (возврат в календарь и перенос), «Отменить» (Да/Нет), «◀ Назад».
Дефолтные тексты
about_html:
🔍 Подробнее о консультации\n\nИван Аникеев — вайбкодер, делаю сайты, ботов, быстрые автоматизации, VBA-макросы и прочие сложные ИТ-продукты. Создадим прототип ИТ-продукта прямо на консультации.\n\nНа консультации вы получите:\n1) Понимание, как дальше развивать продукт\n2) Как работать в Cursor\n3) Предложение по формату 1-на-1: от идеи до результата\n\n💡 Формат: 1 час онлайн-встречи\n💰 Стоимость: 7500 ₽
Проверка P1
– При старте в консоли есть строка 📅 Slots ready: ... и свободных ≥12.
– /start → A + B. «Записаться» → День → Время → C (контакт) → D (запрос+напоминание) → Подтверждение → запись.
– /my показывает созданную запись. Телефон ловится через contact.

P2 — Уведомление админу + кнопки ✅/❌/✉ (идемпотентно) + /whoami**
Продолжи проект из P1. Ничего не ломай. Всё по-прежнему .ts.
Устойчивые уведомления
– initNotifyRoute(telegram,{adminId?,logChatId?}) → "admin"|"log"|"none":
Тихий ping ADMIN_ID (sendMessage('Bot ready'), тут же удаляй); если 400/403 — пробуй LOG_CHAT_ID; если тоже нельзя — "none". Ничего не бросай.
– safeAdminNotify(route, html, inline?) — try/catch, ошибки только console.warn.
Шаблон уведомления о новой записи (HTML, экранируй значения)
– Заголовок «🆕 Новая запись»
– Поля: Имя/ID, @username, Дата, Время, Контакт, Запрос, ID брони.
– Инлайн-кнопки:
• «✅ Подтвердить» → callback "admin:ok:"
• «❌ Отклонить» → "admin:no:"
• «✉ Ответить» → "admin:reply:"
• «≡ Админ» → "admin:dash"
Идемпотентные обработчики
– Доступ только ADMIN_ID — иначе answerCallbackQuery('Только админ').
– booking.state ∈ {'pending','confirmed','rejected'}.
– admin:ok:
• если state!'pending' → answerCallbackQuery('Уже: '+state), отключи клавиатуру сообщения (editMessageReplyMarkup([])).
• иначе: state='confirmed'; сохранить; пользователю sendMessage
«✅ Ваша запись подтверждена\n<дата/время>» (+ кнопка «📌 Мои записи»);
у админа — отредактируй сообщение «✅ Подтверждено» и убери клавиатуру.
– admin:no:
• если state!'pending' → как выше.
• иначе: state='rejected'; освободить слот; сохранить; пользователю sendMessage
«❌ Запись отклонена\nВыберите другое время (кнопка «🗓 Записаться»)»; у админа — «❌ Отклонено», клавиатуру убрать.
– admin:reply: — следующий текст админа отправить пользователю; «Отправлено», вернуть меню.
– admin:dash — пока просто выведи краткую сводку в одном сообщении: свободные/всего за 7 дней, количество активных записей (сегодня/неделя/всего). Кнопка «◀ Назад».
Сервис
– /whoami — верни ctx.from.id и ctx.chat.id.
Проверка P2
– После брони админу приходит карточка с рабочими кнопками.
– Повторные нажатия по ✅/❌ корректно отвечают «Уже: ...», без ошибок, клавиатура отключается.
– Пользователь получает подтверждение/отклонение.
– /whoami работает.

P3 — финал с фиксамии: кнопка админа, понятная инструкция слотов, алерт админу при отмене
Продолжи проект из P2. Важно:
Только .ts в src, ESM, импорты с суффиксом .js, типы через import type.
parse_mode — только "HTML" для системных сообщений. Пользовательские тексты — plain text.
Все админ-хендлеры регистрируй ПЕРЕД bot.on('text')/bot.on('contact').
Любой callback завершаем ctx.answerCbQuery().
Цели P3 (оставляем как в P2 + фиксы):

«≡ Админ» и /admin — единое админ-сообщение (upsert). Фикс: кнопка админа показывается всегда админу.
«Слоты» — управление неделей и днями. Добавление слотов ТОЛЬКО через «Добавить текстом» на экране недели.
В дне — только открыть/закрыть/удалить существующие (без добавления).
Фикс: в инструкции явно описан формат ввода.
«Записи» — список ближайших, действия ✅/❌/✉/⤴ и полный просмотр карточки.
«Тексты» — редактор без HTML: welcome_text, about_text, next_steps_text и др., мгновенное применение.
Фикс: при отмене записи пользователем админ получает уведомление.
Структура/файлы, которые нужно ДОБАВИТЬ/ОБНОВИТЬ:

src/admin/ui.ts — singleton AdminUI с upsert одного сообщения админки.
src/logic/slots.ts — хелперы слотов (загрузка/сохранение/группировка/операции/парсер формата).
src/logic/booking.ts — список/поиск/обновление/перенос/отмена.
data/messages.json — добавить ключи текстов (если нет).
Регистрация экшенов admin в src/core/index.ts ДО общих on('...').
Базовый роутинг и единое сообщение
Префикс админ-callback: "adm:*".
isAdmin(ctx): const A = Number(process.env.ADMIN_ID||0); return A>0 && ctx.from?.id===A;
На любой "adm:*" от не-админа → answerCbQuery('Только админ') и return.
Гарантия кнопки админа. Сделай вспомогательную функцию:
function withAdminBtn(ctx, kb){ return isAdmin(ctx) ? [...kb, [{ text:'≡ Админ', callback_data:'adm:root' }]] : kb }
Применяй её ко всем пользовательским экранам (главное меню, календарь, подтверждение и т.д.).
setMyCommands:
/start, /menu, /book, /my, /help
Если isAdmin(ctx) при /start — дополнительно зарегистрируй /admin для этого чата.
/admin (только админ) и action 'adm:root' → renderAdminRoot():
HTML: "Админ-панель\nВыберите раздел."
Кнопки (2 колонки):
[Слоты][Записи]
[Тексты][Настройки]
[◀ Назад]
AdminUI (src/admin/ui.ts):
class AdminUI { chatId=ADMIN_ID; msgId?:number; filterFreeOnly=false; weekOffset=0;
async upsert(bot, html, reply_markup) {
// если есть msgId → editMessageText; ошибки 400/403 "can't be edited"/"not found" → sendMessage и запомнить msgId
// 400 "message is not modified" — аккуратно игнорировать (не падать)
}
}
Редактор текстов — plain text (как в прошлой версии)
data/messages.json — добавить ключи при отсутствии:
welcome_text, about_text, next_steps_text, reminderOneHour, reminderSoon, cancelAsk, cancelDone.
Пользовательские экраны каждый раз читают свежий messages.json.
Раздел «Тексты»:
adm:texts → список: " — 👁 Предпросмотр • ✏ Изменить", низ [◀ Назад].
adm:t:view: → первые 300 символов + [◀ Назад].
adm:t:edit: → session.adminEdit={key}; в ЛС админу: "Редактирование . Пришлите новый текст."
bot.on('text'): если это админ и adminEdit активен → превью «До/После» + [💾 Сохранить|adm:t:save] [↩ Отменить|adm:t:cancel]
adm:t:save → записать, сбросить, "✅ Сохранено", вернуться к adm:texts.
adm:t:cancel → сброс, "Отменено", adm:texts.
Слоты — только «Добавить текстом» (неделя); в дне — без добавления
Типы/утилиты (src/logic/slots.ts):
export type Slot = { iso:string; taken?:boolean; closed?:boolean }
loadSlots()/saveSlots(slots) — сортировать по iso перед сохранением.
slotsByDateTZ(slots, tz): Map<'YYYY-MM-DD', Slot[]>, сортировка по времени.
safeLabelDate(dateISO, tz) → "dd.MM (EEE)" (locale 'ru'), без "Invalid DateTime".
daySummary(daySlots, tz, nowTZ=DateTime.now().setZone(tz)) → { free, total } где free = !taken && !closed && time>nowTZ.
toISO(dateISO:'YYYY-MM-DD', hhmm:'HH:mm', tz) → string.
isFuture(iso, tz): boolean.
addSlot(dateISO, hhmm, tz) → { ok:true } | { ok:false; reason:'duplicate'|'past'|'invalid' }
toggleSlot(dateISO, hhmm, tz, toClosed:boolean) → { ok:true } | { ok:false; reason:'notfound' }
deleteSlot(dateISO, hhmm, tz) → { ok:true } | { ok:false; reason:'taken'|'notfound' }
Экран «Слоты» — неделя (adm:slots)
Верх:
[➕ Добавить текстом|adm:slots:addtext] [Только свободные: ON/OFF|adm:slots:toggle]
Навигация:
[⟵ Неделя|adm:slots:prev] [Сегодня|adm:slots:today] [Неделя ⟶|adm:slots:next]
Заголовок: "Неделя DD.MM–DD.MM".
Список дней:
"ДД.MM (EEE) — свободно {free} / всего {total}" + [▶ День|adm:day:YYYY-MM-DD]
(если filterFreeOnly=ON — скрывать дни с free=0)
Низ:
[🔄 Обновить|adm:slots] [◀ Назад|adm:root]
Глобальное добавление слотов — adm:slots:addtext (Фикс: явный формат)

session.adminAddRule=true.
В ЛС админу отправь инструкцию (plain text, без HTML):
Добавление слотов (общий формат ввода):
ФОРМАТ 1 — один день: ДД.ММ.ГГГГ ЧЧ:ММ
ФОРМАТ 2 — один день, несколько времен: ДД.ММ.ГГГГ ЧЧ:ММ, ЧЧ:ММ, ...
ФОРМАТ 3 — диапазон дней (каждый день): ДД.ММ.ГГГГ-ДД.ММ.ГГГГ ЧЧ:ММ
ФОРМАТ 4 — диапазон + несколько времен: ДД.ММ.ГГГГ-ДД.ММ.ГГГГ ЧЧ:ММ, ЧЧ:ММ, ...
Обязательно ставим короткое тире

Примеры:
• 20.09.2025 18:00
• 20.09.2025 10:00, 14:30, 19:00
• 20.09.2025–25.09.2025 18:00
• 20.09.2025–25.09.2025 11:00, 15:00, 19:00

Правила:
• Прошедшее время — пропускаем.
• Дубликаты — пропускаем.
• Ошибочные строки — считаем как invalid.
Отмена режима — /cancel

Следующий текст от админа парсится по 4 форматам; для каждой пары {dateISO, hhmm} → addSlot().
Верни сводку: "✅ Добавлено: X • дубликаты: Y • прошлое: Z • некорректные: K".
session.adminAddRule=false; перерисуй adm:slots с текущим weekOffset.
/cancel в этом режиме — отменяет ожидание.
Экран дня — adm:day:YYYY-MM-DD (без добавления)
Заголовок: "${safeLabelDate(dateISO,TIMEZONE)} — свободно {free} / всего {total}"
Подпись курсивом:
"Чтобы добавить новые слоты — вернитесь в «Слоты» → «➕ Добавить текстом»."
Кнопки над списком:
[⟵ К неделе|adm:slots] [🏠 Меню|adm:root]
Список слотов:
• Занят — текст: "🔒 Занят — HH:MM"
• Закрыт — [• Открыть HH:MM|adm:slot:open:DATE:HHmm] [🗑 Удалить HH:MM|adm:slot:del:DATE:HHmm]
• Свободен — [× Закрыть HH:MM|adm:slot:close:DATE:HHmm] [🗑 Удалить HH:MM|adm:slot:del:DATE:HHmm]
Действия:
adm:slot:close/open → toggleSlot(); "Закрыто"/"Открыто"; перерисовать день.
adm:slot:del → deleteSlot(); если 'taken' → "Нельзя удалить: слот занят записью"; иначе "Удалено"; перерисовать день.
Вырежи любые старые обработчики добавления в дне (adm:day:addslot, adm:add:DATE:, adm:pad*).
Записи — список, полный просмотр и действия
adm:bookings — ближайшие 10 активных (!cancelledAt, state∈{'pending','confirmed'}, slotISO>now):
[📄 ДД.MM HH:MM — @username/контакт — state | adm:bk:view:]
[✅|adm:bk:ok:] [❌|adm:bk:no:] [✉|adm:bk:msg:] [⤴ Перенести|adm:bk:move:]
Низ: [◀ Назад|adm:root]
Полный просмотр — adm:bk:view::
"Запись\nID: \nСтатус: \nПользователь: <@username|—> (ID: )\nЧат: <chatId|—>\nКонтакт: \nДата/время: <dd.MM HH:MM> ()\nЗапрос: <summary|—>"
Кнопки: ✅/❌/✉/⤴ и [◀ К списку|adm:bookings]
Действия:
ok — если state!=='pending' → "Уже: "; иначе state='confirmed', сохранить; пользователю "✅ Ваша запись подтверждена\nДД.MM HH:MM"; перерисовать.
no — если state!=='pending' → "Уже: "; иначе state='rejected', освободить слот; пользователю "❌ Запись отклонена\nВыберите другое время: /book"; перерисовать.
msg — session.adminMsg={id}; следующий текст админа → booking.chatId; "Отправлено"; перерисовать.
move — шаг A: 7 дней с ≥1 свободного → [ДД.MM|adm:mv:day::YYYY-MM-DD] → шаг B: свободные времена → [HH:MM|adm:mv:time::YYYY-MM-DD:HHmm] → перенос (старый освободить, новый занять), пользователю "Перенос подтверждён: ДД.MM HH:MM", админу "✅ Перенесено", перерисовать.
Пользовательская отмена — уведомлять админа (Фикс)
В «📌 Мои записи» при «Отменить»:
• подтвердить «Да/Нет»; при «Да» — booking.cancelledAt=Date.now(); соответствующий слот сделать taken=false; сохранить.
• пользователю: "❌ Запись отменена. Можете выбрать другое время: /book".
• safeAdminNotify: админу HTML-карточку "🛑 Отмена пользователем" (Имя/ID, @username, дата/время, контакт, ID брони).
• Перерисовать «Мои записи».
Устойчивость и перерисовка
Любое действие: read → modify → write → re-read → AdminUI.upsert текущего экрана.
Любой callback — короткий answerCbQuery().
AdminUI.upsert: игнорировать 400 "message is not modified".
safeLabelDate — без "Invalid DateTime".
Критерии приёмки
«≡ Админ» и /admin доступны админу на любом пользовательском экране.
«Слоты»:
— Неделя листается; «Только свободные» работает.
— «Добавить текстом» принимает 4 формата; сводка: добавлено/дубликаты/прошлое/invalid.
— Экран дня позволяет ОТКРЫТЬ/ЗАКРЫТЬ/УДАЛИТЬ существующие слоты.
«Записи»:
— Список и полный просмотр работают; ✅/❌/✉/⤴ выполняются; пользователь получает уведомления; UI обновляется.
«Тексты»:
— Редактор plain text; «Сохранить» — тексты сразу применяются.
Пользовательская отмена:
— Слот освобождается; пользователю приходит подтверждение; админу — уведомление.
Если после вставки кнопка «≡ Админ» всё ещё не видна — проверь, что ADMIN_ID в .env совпадает с твоим числовым ID и в рендерах реально вызывается withAdminBtn(ctx, kb).