graphify

Что такое graphify

graphify превращает кодовую базу в структурированный граф знаний. Вместо того чтобы читать сотни файлов при каждом вопросе об архитектуре, Claude обращается к предвычисленному графу — это быстрее и даёт кросс-модульный контекст, который невозможно получить из поиска по файлам.

Текущее состояние графа

Все выходные файлы находятся в graphify-out/:

graphify query — широкий поиск по графу

BFS-обход графа по вопросу на естественном языке. Возвращает связанные узлы в порядке близости к запросу.

copygraphify query "как работает блокировка абонентов"
graphify query "биллинг ежемесячный" --budget 3000
graphify query "YooKassa платёж webhook" --dfs
graphify query "SORM экспорт FTP"

graphify path — кратчайший путь между понятиями

Находит цепочку связей между двумя узлами. Полезно для понимания зависимостей.

copygraphify path "BaseView" "FinanceOperations"
graphify path "AbonentsBlock" "FreeScoutClient"
graphify path "MobileJWTAuthentication" "Abonents"
graphify path "billing_worker" "UsersUsluga"

graphify explain — объяснение узла

Возвращает plain-language описание узла и его ближайших соседей в графе.

copygraphify explain "BaseView"
graphify explain "MsgStack"
graphify explain "MoneyField"
graphify explain "FinanceOperations"

graphify update — обновление после изменений кода

Перечитывает Python-файлы и обновляет AST-часть графа. Без LLM-вызовов — бесплатно и быстро.

copycd carbon_modern
graphify update .
# Перестраивает AST для изменённых .py файлов
# Семантические узлы (HTML, docs) остаются из кэша

Интерактивная визуализация

Откройте graphify-out/graph.html в браузере — интерактивный граф с поиском и легендой сообществ.

God nodes — ключевые абстракции

Узлы с наибольшим числом рёбер. Это точки, через которые проходит большинство кросс-модульных зависимостей.

34 именованных сообщества

Алгоритм Louvain обнаружил 34 кластера. Каждый — логический модуль или слой системы.

Ключевые архитектурные инсайты

Перестройка графа

Быстрое обновление (AST, после изменений .py файлов)

copycd carbon_modern
graphify update .

Полный rebuild (после изменений шаблонов или добавления новых модулей)

copy# Шаг 1: перестройка AST + merge с семантикой
cd carbon_modern && python graphify-out/run_pipeline.py

# Шаг 2: применить именованные метки сообществ
python graphify-out/run_labels.py

Полный цикл с новой семантической экстракцией (дорого — LLM)

copy# Только если добавились новые HTML/docs файлы
cd carbon_modern
/graphify billing/
# Запускает detect → AST → semantic subagents → merge → build → cluster → report

Pipeline-скрипты

Проанализированные репозитории со skills

Раунд 1 — UI/дизайн (апрель 2026)

Раунд 2 — бэкенд/разработка (апрель 2026)

Раунд 3 — UX-аудит и проектирование (апрель 2026)

Установленные skills — инструкция

/building-forms — формы и валидация

Когда вызывать

• Новая форма регистрации или редактирования абонента
• Wizard-шаг в AbonentWizard
• Модальный редактор (UsersModal, ServiceModal, FinOpsModal)
• Нужна валидация с понятными сообщениями об ошибках
• Требования по accessibility WCAG 2.1 AA (нет — по умолчанию у AdminLTE)

Ключевые паттерны для проекта

copy# Django template — стандартный паттерн с Bootstrap
<div class="form-group {% if form.email.errors %}has-error{% endif %}">
  <label for="{{ form.email.id_for_label }}">Email</label>
  {{ form.email }}
  {% if form.email.errors %}
    <div class="invalid-feedback" role="alert">{{ form.email.errors.0 }}</div>
  {% endif %}
</div>

/creating-dashboards — дашборды и KPI

Когда вызывать

• Добавляете новую карточку на /admin/welcome/
• Строите или переделываете /admin/reports/dashboard/
• Нужен ApexCharts-чарт с периодом (месяц/квартал/год)
• Нужна real-time метрика (polling или SSE)

Стандартный AJAX-эндпоинт для KPI

copy# billing/views/reports.py — шаблон KPI-эндпоинта
def dashboard_kpi_api(request):
    period = request.GET.get('period', 'month')
    # current + previous период → delta в %
    revenue = FinanceOperations.objects.filter(...).aggregate(Sum('op_summa'))
    # ВСЕГДА делить на DB_MONEY_KOEF перед отдачей в JSON
    return JsonResponse({
        'revenue': float(revenue / DB_MONEY_KOEF),
        'revenue_pct': round(pct, 1),
    })

copy// ApexCharts — уже подключён в проекте, тема из AdminLTE
const chart = new ApexCharts(document.getElementById('rev-chart'), {
  chart: { type: 'area', height: 200, toolbar: { show: false } },
  series: [{ name: 'Выручка', data: chartData }],
  xaxis: { type: 'datetime', labels: { format: 'dd.MM' } },
  yaxis: { labels: { formatter: v => v.toLocaleString('ru-RU') + ' ₽' } },
  theme: { mode: document.documentElement.dataset.theme || 'light' },
  colors: ['#43b77a'],
});

/designing-apis — REST API дизайн

Когда вызывать

• Проектируете новый эндпоинт в mobile_api/views/
• Добавляете ресурс в rest_api/v2/
• Планируете breaking change (нужна новая версия?)
• Нужна cursor-пагинация для большого датасета (>100к строк)

Правило денег в API-ответах

copy# Всегда в сериализаторе:
def get_balance(self, obj):
    return float(obj.account.ostatok / DB_MONEY_KOEF)  # ✓

# НЕ так:
return obj.account.ostatok  # ✗ — вернёт 12345678900000, фронт сломается

Выбор пагинации

Стандартный формат ошибки

copy{
  "error": "validation_error",
  "message": "Поле email обязательно",
  "details": [
    { "field": "email", "code": "required", "message": "Введите email адрес" }
  ]
}

/impeccable — детальный UI-рефакторинг

Когда вызывать

• Серьёзный редизайн страниц ЛК (/lk/)
• Работа над публичным сайтом документации (docs.billing.smit34.ru)
• Нужны конкретные команды: /critique, /polish, /typeset, /animate

18 команд impeccable

/ui-refactor — тактический UI (AdminLTE)

Когда вызывать

• Улучшаете конкретную страницу AdminLTE не меняя функциональность
• Нужны рекомендации по spacing, цвету, типографике для Bootstrap 5
• Анализ визуальной иерархии формы или таблицы

Передать URL страницы в аргументах

copy/ui-refactor https://testbill.smit34.ru/admin/welcome/
/ui-refactor https://testbill.smit34.ru/admin/Abonents/9001/
/ui-refactor https://testbill.smit34.ru/lk/

Skill работает в 4 шага: начинает с grayscale → решает структурные проблемы → подбирает цвет → применяет тактики из 5 reference-файлов (hierarchy, layout-spacing, typography, color, depth-and-polish).

/graphify — перестройка графа знаний

Когда вызывать

• Добавили значимый блок нового кода (новый модуль, новые views)
• Переименовали классы или переместили файлы
• Хотите включить новые документы или шаблоны в семантический граф

Два режима обновления

/debugging-techniques — отладка Python и Docker

Когда вызывать

• Непонятное поведение Django view, Celery task или billing_worker
• Нужно войти в запущенный Docker-контейнер и исследовать состояние
• Отладка в production без перезапуска сервиса
• Тест падает — нужно остановиться на строке падения

Быстрая шпаргалка для проекта

copyimport pdb; pdb.set_trace()   # в любом месте кода
# или Python 3.7+
breakpoint()

copyfrom celery.contrib import rdb
rdb.set_trace()
# подключиться: telnet localhost 6899

copydocker exec -it $(docker compose ps -q web) bash
python manage.py shell
# или tail -f /var/log/django/error.log

copypytest --pdb billing/tests/
pytest -x  # стоп после первого падения

/optimizing-sql — оптимизация запросов PostgreSQL

Когда вызывать

• Страница грузится медленно — подозрение на медленный запрос
• Нужно добавить индекс на production без downtime
• Django ORM генерирует N+1 запросов
• Отчёт по FinanceOperations (419K строк) тормозит

5-шаговый процесс

copy# Добавить индекс в production БЕЗ блокировки таблицы
# migrations/0052_add_finops_index.py
class Migration(migrations.Migration):
    atomic = False  # обязательно для CONCURRENTLY
    operations = [
        migrations.RunSQL(
            "CREATE INDEX CONCURRENTLY idx_finops_date "
            "ON finance_operations (op_date DESC)",
            "DROP INDEX IF EXISTS idx_finops_date"
        ),
    ]

copy# Диагностика N+1 в Django
from django.test.utils import CaptureQueriesContext
from django.db import connection
with CaptureQueriesContext(connection) as ctx:
    list(Abonents.objects.filter(enabled=True).select_related('tarif'))
print(f"{len(ctx.captured_queries)} queries")  # должно быть 2, не 4270

/testing-strategies — тесты для Django/Python

Когда вызывать

• Пишете тест для новой фичи — непонятно unit или integration
• Нужно покрыть billing_worker тестами перед monthly billing
• Настройка pytest + coverage для нового модуля
• Тест для REST API (mobile_api или rest_api/v2)

/using-relational-databases — Django ORM и PostgreSQL

Когда вызывать

• Проектируете новые модели Django
• Пишете сложные агрегации с MoneyField (деньги ×10¹⁰)
• Планируете крупную миграцию (>100k строк) без даунтайма
• Connection pooling или оптимизация под высокую нагрузку

/ux-designer — современный UX 2025

Когда вызывать

• Проектируете новый экран или пользовательский поток
• Хотите проверить решения по стандартам WCAG 2.2 AA
• Нужны decision trees для выбора компонента (Modal vs SidePanel vs FullPage)
• Работаете над AI-интерфейсом (чат, автодополнение)

/don-norman-principles-audit — аудит по Норману

Когда вызывать

• Нужен структурированный аудит страницы с приоритизацией проблем
• Пользователи жалуются на непонятность, но непонятно что именно
• Хотите аргументировать UX-решение через теорию
• Готовите отчёт об улучшениях для стейкхолдеров

7 принципов Нормана

copy# Пример аудит-запроса
Используй /don-norman-principles-audit
Проведи аудит страницы /admin/Abonents/search/
Фокус: новый оператор, первый день работы
Задача: найти абонента и открыть его карточку

/cognitive-walkthrough — обучаемость интерфейса

Когда вызывать

• Новая фича готова, хотите проверить до пользовательского тестирования
• Нужно оценить, сможет ли новый оператор разобраться без обучения
• Сравниваете два варианта дизайна по обучаемости
• Нет доступа к реальным пользователям

4 вопроса когнитивного обхода

/ux-audit-rethink — комплексный IxDF-аудит

Когда вызывать

• Нужен полный аудит раздела или продукта с числовой оценкой
• Хотите получить приоритизированный роадмап UX-улучшений
• Готовите отчёт по международным стандартам (ISO 9241-11)
• Перед крупным редизайном — зафиксировать baseline

Три слоя оценки

copy# Пример запроса комплексного аудита
Используй /ux-audit-rethink
Проведи аудит раздела управления абонентами
Основные пользователи: операторы биллинга (опытные, ежедневное использование)
Топ-5 задач: поиск абонента, просмотр баланса, добавление услуги,
  создание финансовой операции, блокировка за долг