
Дисклеймер: это мой пет-проект и статья о нём, без заказного продвижения. Кода в статье будет больше, чем маркетинга.
Обычные таск-менеджеры проектируют под одного человека: мой день, мои проекты, мои привычки. В семье всё ломается. У взрослых работа и быт, у детей школа и кружки, а общий список часто живёт в голове у одного человека.
«Чеклист дел» — попытка собрать это в одном месте: день, неделя, месяц, год, повторяющиеся дела, детский режим, напоминания и офлайн-работа. Ниже — как устроен проект, какие решения оказались удачными и где пришлось переделывать.
Какие были ограничения
С самого начала я зафиксировал несколько требований:
PWA, а не нативное приложение. Не хотелось зависеть от App Store, Google Play и аккаунтов разработчика.
Работа на телефоне в первую очередь. Настольная версия — приятный бонус, но основной сценарий — «достал телефон на кухне».
Офлайн. Ребёнок может отметить задачу в машине или в школе без интернета.
Дети как отдельные пользователи. Не просто «ещё один список», а свой вход, свои права и свой экран.
Минимум сущностей. Не проекты, не доски, не спринты. Чеклист, задача, повторение, ребёнок.
Из этого вырос стек: React + Vite на клиенте, Fastify + PostgreSQL на сервере, Docker Compose и nginx на деплое.
Архитектура

Клиент — React 19, React Query, Dexie для офлайн-данных и Workbox для service worker. Сервер — Fastify 5, PostgreSQL, JWT на 15 минут и refresh-cookie на 30 дней. Статику и API раздаёт nginx, всё живёт в Docker Compose.
Почему Fastify, а не Nest или Express:
схема валидации через Zod уже была в общем пакете;
меньше магии, чем в Nest, и понятнее, что происходит на каждом запросе;
скорость разработки на пет-проекте важнее «энтерпрайзности».
Монорепозиторий на pnpm: apps/web, apps/api, packages/shared. В shared лежат типы, Zod-схемы и чистые функции вроде расчёта периода и раскрытия повторений. Это позволяет не дублировать контракты между фронтом и бэком.
Модель данных
Основные таблицы:
users— взрослые и дети, роль, статус, настройки;checklists— день/неделя/месяц/год, дата начала, владелец, режим сортировки;tasks— задача, дата, время, статус, приоритет, оценка времени;recurrence_rules— правило повторения;parent_child_links— связь родителя и ребёнка с правами;routines— сохранённые наборы задач;remindersиdevices— push и будильники.
Чеклист не хранит список задач как JSON. Задачи лежат отдельно, потому что у них есть статус, исполнитель, напоминания и история. JSON-поле было бы проще для прототипа, но быстро стало бы болью при отчётах и повторениях.
Период задаётся парой period_type + period_start. Для дня это конкретная дата, для недели — понедельник (или день, с которого начинается неделя у пользователя), для месяца — первое число.
Неделя по дням, а не одна простыня
Первая версия недельного чеклиста была обычным списком. На реальных данных выяснилось: 30 задач подряд — это не план, а стена текста. Пришлось группировать по дням.
Теперь API отдаёт задачи в хронологическом порядке, а фронт раскладывает их по plannedDate. Внутри дня — сортировка по времени, а не по порядку добавления.
В PostgreSQL это выглядит так:
sql
SELECT t.* FROM tasks t WHERE t.checklist_id = $1 AND t.deleted_at IS NULL ORDER BY CASE WHEN $2 = 'MANUAL' THEN t.sort_order END ASC, CASE WHEN $2 = 'TIME' THEN COALESCE(t.scheduled_start_at, t.due_at) END ASC NULLS LAST, CASE WHEN $2 = 'TIME' THEN t.planned_date END ASC NULLS LAST, t.sort_order ASC, t.created_at ASC;
Здесь есть важный компромисс. Сортировка по времени — режим по умолчанию, но если человек явно перетащил задачу, чеклист переходит в MANUAL и сохраняет его порядок. Иначе drag-and-drop был бы бессмысленным: любое обновление страницы возвращало бы хронологию.
Для этого в checklists появилось поле:
sql
ALTER TABLE checklists ADD COLUMN IF NOT EXISTS sort_mode text NOT NULL DEFAULT 'TIME' CHECK (sort_mode IN ('TIME', 'MANUAL'));
Сохранение ручного порядка — отдельный endpoint. Он принимает все задачи чеклиста, проверяет, что список не изменился с момента открытия, и в транзакции перезаписывает sort_order:
ts
await app.db.transaction(async (tx) => { for (const [index, taskId] of input.taskIds.entries()) { await tx.query( 'UPDATE tasks SET sort_order = $2, updated_at = now() WHERE id = $1', [taskId, index], ); } await tx.query( "UPDATE checklists SET sort_mode = 'MANUAL', updated_at = now() WHERE id = $1", [id], ); });
На клиенте — @dnd-kit/core и @dnd-kit/sortable. Отдельный компонент SortableTaskRow даёт ручку и transform, а DndContext оборачивает список дня:
tsx
const sensors = useSensors( useSensor(PointerSensor, { activationConstraint: { distance: 6 } }), useSensor(TouchSensor, { activationConstraint: { delay: 180, tolerance: 6 }, }), ); <DndContext sensors={sensors} collisionDetection={closestCenter} onDragEnd={(event) => handleDragEnd(event, dayTasks, dayKey)} > <SortableContext items={dayTasks.map((task) => task.id)}> {dayTasks.map((task) => renderTaskRow(task, true))} </SortableContext> </DndContext>

Неделя разбита на дни; внутри дня — время, длительность и ручка для ручной сортировки.
Отдельная история — часовые пояса. Даты хранятся как date, время — как timestamptz. В UI время показывается в часовом поясе пользователя, а не сервера. Иначе задача «в 18:00» у пользователя в Калининграде и в Москве вела бы себя по-разному.
Офлайн-режим
PWA без офлайна — это просто сайт с иконкой. Мне нужен был сценарий: открыл приложение без сети, отметил задачу, закрыл, а при появлении связи изменение улетело на сервер.
Со стороны service worker API-запросы идут по стратегии network-first с кэшем:
ts
registerRoute( ({ url, request }) => request.method === 'GET' && url.pathname.startsWith('/api/v1/'), async ({ request }) => { const cache = await caches.open(apiCacheName(request)); try { const response = await fetch(request); if (response.ok) { await cache.put(request, response.clone()); } return response; } catch (error) { const cached = await cache.match(request); if (cached) return cached; throw error; } }, );
Кэш именуется по пользователю (api-${userId}), чтобы на общем устройстве после смены аккаунта не показать чужие данные.
Мутации складываются в IndexedDB-очередь:
ts
export async function enqueueTaskAction(userId, taskId, action) { const row = { id: crypto.randomUUID(), userId, taskId, action, createdAt: Date.now(), attempts: 0, }; await offlineDb.queue.put(row); return row; }
При восстановлении связи очередь проигрывается по порядку. Каждое действие отправляется с Idempotency-Key, равным id записи в очереди:
ts
await api.post(`/tasks/${row.taskId}/${row.action}`, undefined, { headers: { 'Idempotency-Key': row.id }, });
Это важно: сеть может оборваться после того, как сервер уже применил действие, но до ответа. Без идемпотентности повторная отправка завершила бы задачу дважды или создала дубль.
Очередь не пытается быть «умной». Если пришёл 401/403, действие остаётся и ждёт повторного входа. Если 4xx, кроме 429, — задача, скорее всего, удалена или действие недопустимо, запись удаляется. Сетевые ошибки — стоп и повтор позже.

Мобильная версия: тот же API, но основной сценарий — телефон и офлайн.
Повторения
Повторения — это отдельная таблица правил, а не флаг на задаче:
sql
CREATE TABLE recurrence_rules ( id uuid PRIMARY KEY DEFAULT gen_random_uuid(), task_template_id uuid NOT NULL REFERENCES tasks(id) ON DELETE CASCADE, freq text NOT NULL, interval integer NOT NULL DEFAULT 1, by_weekday integer[], until date, count integer, reminder_config jsonb NOT NULL DEFAULT '[]'::jsonb, active boolean NOT NULL DEFAULT true );
Раскрытие дат — чистая функция occurrenceDates(rule, originDate, start, horizonEnd). Она не ходит в базу, не знает про HTTP и легко тестируется. Генератор задач вызывает её на горизонте 45 дней и пропускает уже существующие даты.
ts
const dates = occurrenceDates( { freq, interval, byWeekday }, originDate, start, horizonEnd, ); for (const date of dates) { if (existingDates.has(date)) continue; await createTaskFromTemplate(tx, template, date); }
Почему не RRULE целиком? Для MVP хватило daily/weekly/monthly/yearly и BYDAY. Полный RFC 5545 с BYSETPOS, исключениями и «каждым вторым вторником» — отдельная большая тема. Когда понадобится, occurrenceDates можно заменить на библиотеку, не переписывая остальной код.
Детский режим
Самая опасная часть — доступы. Ребёнок не должен видеть чужие задачи, а взрослый не должен случайно оказаться в чужом пространстве.
Все обращения к данным идут через resolveOwner. Если актор запрашивает не себя, проверяется, что он взрослый, у него включён родительский режим и есть активная связь с ребёнком:
ts
if (ownerId !== actor.id) { if (actor.accountType !== 'ADULT' || !actor.isParent) { throw forbidden(); } const link = await getActiveParentLink(db, actor.id, ownerId); if (!link) throw forbidden(); }
Права ребёнка хранятся в parent_child_links.permissions: можно ли создавать задачи, редактировать свои, видеть семейные рутины. Проверки дублируются на сервере и в UI, но сервер — источник истины.
Удаление задач сознательно ограничено взрослыми:
ts
if (actor.accountType !== 'ADULT') { throw forbidden('Удалять задачи может только взрослый'); }
В детском интерфейсе кнопки удаления просто нет. Это не про недоверие, а про страховку: ребёнок может случайно стереть важное дело, которое создал родитель.

Детский экран: только свои задачи, прогресс и понятные действия.
Шаблоны расписания
Ещё одна проблема — пустой экран. Человек открывает неделю, видит чистый список и закрывает. Поэтому появились шаблоны: 11 готовых каркасов на будни и выходные.
Внутри — данные, а не магия:
ts
{ id: 'builtin-work-week', title: 'Рабочая неделя без переработок', items: [ { dayOfWeek: 1, title: 'Подъём и стакан воды', time: '07:30', category: 'HEALTH', estimatedMinutes: 10, priority: 'NORMAL', }, // ... ], }
Шаблон применяется на клиенте: проходим по items и создаём задачи через существующий API. Плюс — не нужен отдельный endpoint и миграция. Минус — 20–30 последовательных запросов и возможная частичная ошибка. Если делать это в проде ещё раз, я бы добавил batch-endpoint POST /checklists/:id/tasks/bulk с одной транзакцией.

Шаблоны недели: будни, выходные, подъём, сон и пояснения к делам.
Что вылезло после запуска
Source maps в production
Одна из первых находок аудита: собранные .js.map лежали рядом с бандлом и отдавались всем желающим. Исправил двумя слоями: build.sourcemap = false в Vite и запрет .map на nginx.
Слишком широкий public-префикс
Раньше всё, что начиналось с /api/v1/auth/, считалось публичным. Это удобно, пока не появится новый чувствительный auth-маршрут. Список заменил на точные пути: register, login, refresh, logout, forgot/reset, child-login.
Rate limit и X-Forwarded-For
За nginx request.ip нельзя слепо доверять заголовку. Если nginx пробрасывает клиентский X-Forwarded-For, лимит обходится сменой заголовка. Исправил: nginx перезаписывает X-Forwarded-For реальным адресом, Fastify работает с trustProxy: 1. Проверка: шесть попыток логина с разными подставными IP дают 429 на шестой.
Зависимости
pnpm audit показывал high в Zod 3.25. Обновил до Zod 4.6.7 и перевёл OpenAPI-генерацию на встроенный z.toJSONSchema. Аудит стал чистым, но такие обновления всегда требуют прогона всех схем.
Заголовки безопасности
Добавил CSP, HSTS, nosniff, SAMEORIGIN, Referrer-Policy, Permissions-Policy. Заодно убрал дублирование заголовков между host nginx и контейнером: браузер получал X-Frame-Options дважды.
Тесты и деплой
Сейчас в проекте:
22 unit-теста shared-логики;
63 интеграционных теста API на PGlite;
62 E2E-теста Playwright (мобильный и десктопный viewport);
production offline-тест.
API и фронт собираются в Docker-образы, миграции применяются при старте. На сервере — nginx с TLS от Let’s Encrypt, API и PostgreSQL слушают только localhost.
Отдельно проверяю PWA: манифест, service worker, установку и офлайн-перезагрузку. Это не «поставили плагин и забыли» — service worker легко ломает кэш, если не следить за версиями.
Что не получилось и что дальше
Честный список:
Нет нативного приложения. Это PWA, а не APK/IPA. Для App Store и Google Play нужна отдельная обёртка, подпись и аккаунты.
Нет доставки email. Восстановление пароля технически есть, но письма не отправляются — в production сценарий пока нерабочий.
Нет пользовательских шаблонов. Можно применить готовый и отредактировать задачи, но нельзя сохранить свою неделю как новый шаблон.
Нет SSR. Публичные страницы — React SPA. Для SEO есть sitemap, canonical, JSON-LD и статьи, но серверный рендеринг был бы надёжнее.
Нет batch-применения шаблонов. 30 запросов вместо одного — терпимо, но не идеально.
Из ближайших планов: batch-создание задач, пользовательские шаблоны, более аккуратная работа с повторениями и, возможно, TWA-обёртка для Android.
Ссылки
Приложение: sdelatb.ru
Установка PWA: sdelatb.ru/app
Инструкция: sdelatb.ru/guide
Статьи о планировании: sdelatb.ru/articles
Если у вас есть опыт с PWA, офлайн-очередями или семейными продуктами — буду рад критике. Особенно интересно, где я переусложнил и что можно было сделать проще.
работа с повторениями и, возможно, TWA-обёртка для Android.
