DA @dartway_dev_ru
Showing posts older than #146 · Back to latest
dart pub global activate dartway_cli → dartway create. Пустая папка → работающее fullstack-приложение: сервер, база, real-time, авторизация. Один язык от базы до виджета.DwCrudConfig на модель описывает всё поведение: кто читает, кто пишет, какие правила. Эндпоинты писать не нужно — их нет. Фича приходит из модели, а не из руками собранного API.ref.watchModelList<T>() — одна строка: real-time-синхронизация, пагинация, скелетоны на загрузке. Ни репозиториев, ни сервисов, ни сокетов, ни инвалидации кэша.UserProfile, лимиты и защита от гонок включены по умолчанию. Фреймворк не владеет пользователями приложения.dw.plugins.telegram. Нужно хранилище — dw.plugins.prefs. Не нужно ни то ни другое — в приложение не приезжает ни строчки.DwPlugin. Понадобится проекту аналитика, connectivity, пуши, какой-то свой вендор — разработчик пишет плагин точно так же и достаёт его как dw.plugins.<своё>. Ядро остаётся минимальным контрактом; всё опциональное живёт снаружи и подключается одинаково — и нашими руками, и руками любого, кто ставит пакет.dartway_flutter — всё, что нужно приложению вокруг его данных, до того как появляется первый экран: запуск, действия, асинхронный рендеринг, уведомления, отчёты об ошибках. Не дизайн-система — здесь нет ни одной кнопки. Механизмы, а не внешний вид.DwAppRunner берёт на себя то, что настраивает каждое приложение и не любит настраивать никто: ProviderScope, нативный сплэш, инициализаторы по порядку, зону, которая ловит необработанные ошибки, а не теряет их.dw.action(...) — оборачивает действие пользователя: показывает подтверждение, гоняет loading-состояние, ловит ошибку, шлёт уведомление. Двойной тап не создаёт две записи — защита от повторного нажатия встроена. И это работает под любым виджетом, не только под кнопкой.dwBuildAsync рисует loading / error / data единообразно, а loading — это скелет, построенный из твоего же реального виджета, не спиннер.dw — и обращается к нему отовсюду: dw.action, dw.notify, dw.confirm, dw.plugins.telegram. Одна точка входа, один автокомплит. То, что подключаешь опционально (Telegram, локальное хранилище), — плагины под dw.plugins, за которые платит только тот, кому они нужны.AsyncValue — тип, на котором построен весь async-контракт.flutter run, читаешь сверху вниз.accessFilter), кто — писать (allowSave), что считается валидным (validateSave), что должно случиться в той же транзакции (beforeSaveTransaction). Всё. Эндпоинтов не существует.ref.watchModelList<Booking>() — типизированный живой список. Реалтайм-синхронизация, пагинация, фильтры, скелетные состояния загрузки — из коробки. Кто-то записал модель на сервере — виджет перестроился. Никаких сокетов руками, никаких инвалидаций кэша.watchModelList, сессии, переживающие перезапуск, обработка ошибок, которая отличает сетевой сбой от настоящей поломки.DwButton и DwText. Дизайн-система — единственное, чем любой серьёзный проект в итоге владеет сам, и отдавать её зависимостью значит начать вечный спор про радиус скругления кнопки. UI-кит приезжает в твоё приложение исходником — и дальше он твой.dartway create — проект, который запускается, за считанные секунды), линты и чекер, которые машинно проверяют конвенции, опциональная интеграция с Telegram Mini Apps, мост в DartWay Studio.UserProfile, в твоей базе, с твоими полями и ролями. Не «расширь наш UserInfo», не форк модуля. Это то, обо что разбиваются готовые батарейки: чужую модель не расширить, а форк тащится через каждое обновление.
UserInfo, сообщение — их модель, таблицы — их таблицы. В рамках демо всё прекрасно. Но продукту всегда нужно больше: поле к пользователю, свой флоу верификации, вложения в сообщениях, свои права на канал. И здесь стена: чужую модель не расширить. Варианта два — городить параллельные таблицы со склейками или форкать модуль. А форк — это навсегда: его придётся тащить через каждое обновление фреймворка. Ад поддержки, без преувеличения.UserProfile, в базе приложения, с любыми полями: роли, аватар, всё, что нужно домену. Добавить поле = добавить поле. Не форк.Future<String> hello(Session session, String name).serverpod generate.client.example.hello('world') — как локальную типизированную функцию. Никакого http-клиента руками, никакого Map<String, dynamic>, никакой ручной сборки JSON.
ValueNotifier как будто не считается за взрослое решение.Listenable с одним значением. Меняешь .value — слушатели уведомляются. Оборачиваешь кусок UI в ValueListenableBuilder — и пересобирается только он.final isSaving = ValueNotifier(false);
ValueListenableBuilder(
valueListenable: isSaving,
builder: (_, saving, __) => SaveButton(loading: saving),
);
setState.ValueNotifier — и всё.==, а не по факту изменения. Самые частые грабли — мутабельные объекты:final items = ValueNotifier<List<Task>>([]);
items.value.add(task); // ничего не произойдёт — ссылка та же
items.value = [...items.value, task]; // сработает — новый список
ValueListenableBuilder. Три уровня вложенности — и читается это уже хуже, чем то, от чего вы убегали.AsyncValue бесплатно — и для экранов с загрузкой это реально экономит код и ошибки.autoDispose. Создал — сам не забудь dispose(). На одном экране — мелочь, на десятках — источник утечек.flutter_hooks — ещё прощеdispose. И тут есть два инструмента, которые часто путают:useState(0) — создаёт ValueNotifier и сразу подписывает виджет: поменял .value — хук-виджет пересобрался. Для состояния, которое рисует сам этот виджет.useValueNotifier(0) — только создаёт стабильный ValueNotifier между ребилдами, но НЕ подписывает. Когда нотифаер нужно передать вниз или слушать точечно (например, отдать в ValueListenableBuilder), не перерисовывая весь виджет.dispose. По хукам будет отдельный пост — там подробнее.ValueNotifier закрывает заметно больше, чем ему обычно доверяют. Но у него есть честный потолок, и упираться в него костылями — хуже, чем вовремя взять инструмент потяжелее.ValueNotifier? В каких случаях?
develop. Ниже — рецепт и нюансы, чтобы вы не потратили на это полдня, как мы 🙂/install-github-app из Claude Code или вручную).claude setup-token (логин аккаунтом с активной подпиской Claude) → положить в секрет репо CLAUDE_CODE_OAUTH_TOKEN: gh secret set CLAUDE_CODE_OAUTH_TOKEN --repo <org>/<repo>.github/workflows/claude-review.yml.name: Claude PR Review
on:
pull_request:
types: [opened, synchronize, ready_for_review, reopened]
permissions:
contents: read
pull-requests: write
issues: write
id-token: write # ← без этого не пройдёт OIDC-обмен токена
concurrency:
group: claude-review-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: true
jobs:
review:
if: ${{ github.event.pull_request.head.repo.fork != true }}
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: anthropics/claude-code-action@v1
with:
claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
track_progress: true # ← сводный комментарий
prompt: |
REPO: ${{ github.repository }}
PR NUMBER: ${{ github.event.pull_request.number }}
<инструкции ревью + что пропускать>
Для построчных замечаний используй mcp__github_inline_comment__create_inline_comment (confirmed: true).
Для сводки — gh pr comment. Публикуй только через GitHub-комментарии.
claude_args: |
--model claude-opus-4-8
--max-turns 50
--allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*)"
Workflow validation failed на каждом PR. Экшен требует, чтобы файл workflow был идентичен версии на default-ветке репо. У нас default = master, а файл лежал только на develop → падало всегда. Фикс: workflow должен быть на default-ветке.id-token: write → OIDC-обмен токена не проходит. Это разрешение обязательно.401 Invalid bearer token. Токен в секрете был невалиден - скопирован с переносом строки. Проще всего просто перевыпустить токен claude setup-token и скопировать аккуратно.curl -s -o /dev/null -w "%{http_code}" https://api.anthropic.com/v1/messages \
-H "authorization: Bearer $TOKEN" -H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: oauth-2025-04-20" -H "content-type: application/json" \
-d '{"model":"claude-haiku-4-5-20251001","max_tokens":1,"messages":[{"role":"user","content":"hi"}]}'200 = живой, 401 = бракованный.show_full_output: true (репо приватный — в логи видит только команда), потом убрать.error_max_turns. Дефолт --max-turns 10 мал: на большом PR Claude сжигает ходы на чтении сгенерённого/iOS-кода и не успевает написать ревью. Подняли до 50 + в промпте велели пропускать сгенерённые/платформенные файлы (tvolkova_client, **/generated/**, *.g.dart, *.pbxproj, локфайлы и т.п.).track_progress: true → сводный комментарий;--allowedTools добавить mcp__github_inline_comment__create_inline_comment → построчные комментарии;--allowedTools — это allow-list, так что туда же Bash(gh pr comm--enable-hcpp. Актуально всем, у кого в приложении нативные вьюхи — карты, вебвью.MainAxisAlignment.center пишете просто .center — Dart выводит тип из контекста. Работает с enum-ами, конструкторами, статиками. Визуальный шум в widget-деревьях заметно падает.Map<String, dynamic>. Ошибка в контракте — это ошибка компиляции, а не runtime-краш в продакшне.