2026-09-20 — Мобильное приложение Please Pay Me собрано на iOS-ките

Запрос

«Собери теперь приложение please-pay-me, используя эти компоненты» — то есть поверх Cupertino-кита из прошлой сессии сделать рабочее приложение против существующего API.

Что сделано

Слой данных (`lib/data/`)

models/ — Budget, BudgetStatus (+ вычисляемые spentProgress / dailyProgress), Expense, ExpensesPage, Job, UpcomingPay, WeekendPolicy, AuthUser, AuthSession. Зеркалят web/src/types.ts, парсятся через models/json.dart — толерантные коэрсеры (int/double/string), потому что API отдаёт числа из C#-рекордов.
api/api_client.dart — транспорт на http: Bearer-токен через tokenProvider, маппинг detail/title в ApiException, отдельная обработка 401 с колбэком onUnauthorized (разлогинивает сессию).
repositories/ — интерфейсы BudgetRepository / ExpenseRepository / JobRepository / UserRepository + REST-реализации на все ручки MeController.
demo/demo_backend.dart — in-memory бэкенд, повторяющий математику конверта (dailyLimit = remaining / daysLeft). Используется в демо-режиме, превью и тестах; DemoBackend.empty() — для пустых состояний.

Ядро (`lib/core/`)

config/app_config.dart — PPM_API_BASE_URL, PPM_WEB_URL, PPM_DEMO через --dart-define; пустой адрес API автоматически включает демо-режим.
storage/session_storage.dart — интерфейс + SharedPreferences и in-memory реализации.
state/async_value.dart — sealed AsyncLoading/AsyncData/AsyncError с map(...), чтобы экраны матчились по состоянию, а не жонглировали тремя nullable-полями.
format/formatters.dart — деньги (1 234,50 ₽), русские плюрали, «Сегодня/Вчера».

Состояние (`lib/features/*/`)

SessionController — владеет авторизацией и выдаёт репозитории (REST или demo), так что остальное приложение не знает про токены. sessionKey пересобирает фичевые контроллеры при входе/выходе.
BudgetsController — источник правды по конвертам (список, выбранный, мутации с авто-перезагрузкой, возврат текста ошибки вместо исключения).
JournalController — пагинация + группировка по дням + скоуп «текущий/все».
JobsController — работы и ближайшая выплата.

Экраны (`lib/features/`, `lib/app/`)

Пять вкладок: Обзор, Журнал, Бюджеты, Работа, Профиль (+ экран входа и сплэш). Формы — модальные шиты: новая/редактирование траты, бюджета, работы; все они принимают onSubmit, возвращающий текст ошибки, и не знают про репозитории. _SessionGate разводит restoring / signedOut / signedIn.

Кит

Удалены демо-экраны lib/ui/screens/*; добавлены AppEmptyState, AppErrorView, AppLoadingView, showAppDatePicker, showAppFormSheet.

Widgetbook

Папка Screens теперь показывает настоящие экраны приложения на DemoScope (demo-бэкенд + провайдеры), включая пустые состояния, формы и полный таб-бар.

Авторизация — известное ограничение

Telegram Login Widget работает только в вебе. Мобильный клиент принимает JWT из localStorage.ppm_session_jwt веб-кабинета и валидирует его через GET /api/me. Нативный вход (WebView с Telegram-виджетом либо one-time code через бота) не делался — это отдельное продуктовое решение.

Тесты

mobile: 32 теста — парсинг моделей, форматтеры, все контроллеры на demo-бэкенде, виджет-сценарии (вход, табы, пустые состояния, запись траты end-to-end).
mobile/widgetbook: 100 — каждый use-case рендерится в light и dark.
flutter analyze по обоим пакетам — 0 issues.
flutter build windows --debug проходит (проверка плагинов shared_preferences/url_launcher).

Запуск

cd mobile
.\run.ps1                                     # демо-данные
.\run.ps1 -ApiBaseUrl https://ppm.example.com

5.3 KiB Raw Permalink Blame History Unescape Escape

2026-09-20 — Мобильное приложение Please Pay Me собрано на iOS-ките

Запрос

Что сделано

Слой данных (lib/data/)

Ядро (lib/core/)

Состояние (lib/features/*/)

Экраны (lib/features/, lib/app/)

Кит