готов
Смена
Telegram Mini App и бот для одного мастера: день, клиенты, свободные окна и read-only синхронизация с YCLIENTS без хранения пароля.
Задача
Мастеру нужен день в Telegram: визиты, перерывы, клиенты и свободные окна — без отдельной CRM и без записи в YCLIENTS. Записи администратора подтягиваются только на чтение; свои визиты и заметки мастер ведёт в «Смене».
Решения и почему
- Mini App + бот. День / неделя / месяц, карточки клиентов, статусы «Пришёл / Завершён / Не пришёл», «Поделиться окнами» текстом. Бот отвечает на
/today,/free,/add,/findи ведёт в нужный экран. - YCLIENTS только чтение. Google Calendar iCal или официальный API — пароль YCLIENTS не хранится. Ссылка iCal сидит в SQLite
meta, не в экспорте. - HMAC
initData. Вход через подпись Telegram, срок, allow-list id. Сессия 8 часов: Bearer в памяти + HttpOnly cookie, неlocalStorage. - SSRF на календарном feed. Фиксация адреса, allow-list IP, общий таймаут и проверка сокета после коннекта.
revisionпротив конфликтов. Форма несёт версию данных; правка с другого устройства отклоняется.- Снимки и восстановление. Ежедневные копии БД; перед restore сохраняется текущее состояние.
- Ноль npm-зависимостей. Node 24 stdlib + SQLite.



Архитектура
Доступ: владелец и один второй пользователь (администратор или помощник) по одноразовому приглашению.
Попробовать
Демо на тестовых данных
Загружаем демо…
Код
Проверка HMAC Telegram initData:
const secret = createHmac('sha256', 'WebAppData').update(token).digest();
const expected = createHmac('sha256', secret).update(sorted).digest();
if (!timingSafeEqual(Buffer.from(hash, 'hex'), expected)) {
throw new AppError('AUTH', 'Не удалось подтвердить вход через Telegram.', 401);
}
SSRF: allow-list IP и фиксация адреса на соединении:
export function pinnedFetch(url, { headers = {}, signal } = {}) {
const host = new URL(url).hostname.replace(/^\[|\]$/g, '');
if (isIP(host) && internalAddress(host)) return Promise.reject(blocked());
return new Promise((resolve, reject) => {
const req = httpsRequest(url, { headers, lookup: pinnedLookup, signal }, (res) => {
if (internalAddress(res.socket.remoteAddress || '')) {
req.destroy(blocked());
return;
}
// …
});
req.on('error', reject);
req.end();
});
}
Свободные окна дня (shared.mjs) — те же цифры в UI и в боте:
export function freeGaps(state, date, from = 0, minGap = 15) {
const hours = workday(state, date);
if (hours.closed) return null;
const end = mins(hours.end), out = [];
let scanAt = Math.max(mins(hours.start), from);
const busy = state.records
.filter((r) => r.date === date && isActive(r))
.sort((a, b) => a.time.localeCompare(b.time));
for (const r of busy) {
const start = Math.min(mins(r.time), end);
if (start - scanAt >= minGap) out.push([scanAt, start]);
scanAt = Math.max(scanAt, mins(r.time) + r.duration);
}
if (end - scanAt >= minGap) out.push([scanAt, end]);
return out;
}
Результат и честность
Проверено: npm test (44), локальный /demo, iCal на Google Calendar, ширины 320–1060 px.
Не проверено: полный iframe Telegram Web на 0.5, живой филиал YCLIENTS / API-токены, деплой на VPS в этой среде.