Документация проекта «К2 Репетиторство» (k2-tutoring-oc)

1. Дерево объектов (doc_tree)

23 узла, все плоские (parentId=null, depth=0, archivedAt=null):

Опубликовано узлов: 1614 (isPublished:true) и 1620 (isPublished:true, portalExposed:true).

2. Таблицы: схемы и счётчики

Счётчики — через datatable_aggregate (countBy по status; для таблиц без статуса — countNonEmpty по первой колонке), без выгрузки строк.

Ключевые колонки по таблицам:

1602 Счета (core_invoice)

number (sequence), customer →1606, company →(несвязан), issue_date, due_date, period_start, tax_jurisdiction, rollups total/amount_paid/amount_credited/tax_total, формулы total_gross, outstanding, aging; status (draft,sent,partial,paid,void); student_email, reminder_date, reminder_sent, pause_date, amount (₽).

1603 Позиции счёта (core_invoice_line)

invoice →1602, product →(несвязан), qty, unit_price, формулы line_total, tax_rate (TAX_RATE+LOOKUP), tax_amount, line_total_gross, subscription →1608.

1604 Платежи (core_payment)

invoice →1602, amount, kind, method, формула effect (±amount), paid_at, reference.

1605 Кредит-ноты (core_credit_note)

пустая; number (sequence), invoice →1602, amount, effect=0-{amount}, reason, issued_at.

1606 Ученики (core_customer)

name, контакты (email/phone/parent_*), externalUser (externalPerson — личный кабинет), source, rollups ar_balance, active_memberships, кейсовые: course →1614, absent_streak, last_absence_push, streak_alerted, loyalty_points, marketing_opt_in, owner (person).

1607 Планы абонементов (core_membership_plan)

name, price, billing_cycle, benefits, active.

1608 Абонементы (core_membership) — самая насыщенная (29 колонок)

member →1606, plan →1607, lookups plan_price/plan_cycle/last_invoice_outstanding/last_invoice_due_date, формулы bill_amount, days_past_due, mrr, period_days, converted_next_run; previous_membership →1608 (само_link для смены тарифа); status (trial,active,past_due,cancelled,expired); гейт-колонки due_control_date, paid_flag, pause_date.

1609 Занятия (core_class_session)

title, instructor (person), tutor →1619 (карточка), course →1614, start/end (datetime), capacity, enrolled_count (rollup), seats_left (formula), status (scheduled,in_progress,completed,cancelled), instructor_email; поведение exclusive_scheduling (explicit): resource=tutor, interval=start–end (после рефакта §58: TEXT-ресурс отклонялся scheduling_bad_resource_type, заведён справочник 1619).

1610 Посещения (core_enrollment)

session →1609, member →1606, status (enrolled,attended,no_show,cancelled), pair_key (text, UNIQUE — антидубль), instructor_email.

1614 Курсы (секции) — published

name, age_range, subject, schedule_note, instructor_name, instructor_email. Справочник для course в 1606/1609/1616 и для формы 1620.

1615 Параметры

key, value_num, value_txt (KV-хранилище; значения: допуск дней на оплату 7, пауза 5 и т.п. — 3 записи).

1616 Заявки — вход публичной формы

child_name, child_age (3–18), course →1614, parent_name/email/phone, trial_date, attended, enrolled_flag, params_days_to_pay (снимок), status (new→assigned→trial_done→{student|rejected}, workflow enabled); дедуп-контур (§58): dedup_key (formula CONCAT + unique — НЕ гейтит INSERT) + dedup_guard (TEXT unique + правило 295 — рабочий пост-фактум-гейт).

1617 Успеваемость

student →1606, session →1609, grade (select), comment, grade_date.

1618 Заявки на перенос

session →1609, student →1606, new_date, new_start_time, new_end_time, reason, rs_status (new_rs,agreed,done_rs,rejected_rs).

1619 Преподаватели

name, email, phone — справочник-ресурс для exclusive_scheduling (1609) и писем.

3. Автоматизации (9 правил на 5 таблицах)

Все enabled:true. События/действия — из automation_get_meta.

Цепочка сквозняка: форма 1620 → 1616 (295 дедуп → 292) → 1606 (293) → 1608+1602+письмо (287 биллинг, 291 просрочка, 294 напоминание; 290 пропуски).

4. Формы

5. Дашборды

6. Документы-шаблоны и проверка токенов

В doc_tree нет ни одного узла типа document — в проекте отсутствуют документы/шаблоны писем-документов. Проверка тел на литеральные токены {{col.*}} (известный дефект генератора, блокер волны W-1/D-1) — N/A: проверять нечего. Токены {{col.*}} в телах писем живут в actions правил (290/291/293/294) и являются штатными шаблонами автоматизаций, а не дефектом.

7. Публичный контур (curl, 2026-09-04)

307 не наблюдалось. Приватность неопубликованных объектов подтверждена (404). Проектные настройки: isPublished:true, baseCurrency:RUB, timezone:Europe/Moscow, portalAllowedOrigins:[], externalDirectory:[].

8. Грабли проекта (из dev-report.md / error.md)

9. Открытые вопросы

10. Публичный доступ

Чистка (2026-09-04)

Указание владельца платформы: архивировать пустые и неиспользуемые таблицы проекта (slug k2-tutoring-oc, id 45). Канал — scripts/mcp.py (codedocs MCP); project_use перед каждым батчем записей. Формы/правила/дашборды не трогали (граница задачи).

Живая пустота (datatable_get_rows limit=1 по всем 15 таблицам): пуста только 1605 Кредит-ноты (0 строк); остальные 14 — непустые (n≥1).

Живая проверка использования (формы form_get_meta; правила automation_get_meta по всем 15 таблицам; дашборды dashboard_get_meta — panel bindings; link-колонки — referenceDocumentId и rollup.childDocumentId во всех 15 схемах; публичный контур — isPublished в doc_tree):

Архивировано: 1615 Параметры — непустая (~3 KV-записи), но использование = НОЛЬ по всем контурам (правила 293/294 хардкодят +7/+12 дней вместо чтения из KV; снапшот params_days_to_pay в 1616 значение не подтягивает из 1615; ссылок/дашбордов/форм/публички нет) → архив с данными, doc_archive {"documentId":1615} → archivedIds:[1615] (каскада нет, childCount=0).

Сохранено с причинами:

Итог дерева: узлов было 24 → стало 23 (живых dataTable 15→14; дашборды 5, формы 3, документ 1 — без изменений). Соседние проекты не затрагивались.

Перепубликация документации: тело существующего документа через doc_upsert не обновляется (известное ограничение: «ок» без записи тела) — обход: архив 1746 + пересоздание. См. §10 (ниже, обновлён после пересоздания).