Учебник современной веб-разработки

Atmanki — сквозной пример: от преобразования данных и компонентов React до публикации контента в Strapi и выпуска релиза на VPS. Предполагаем математический бэкграунд; JavaScript и инструменты разработки вводятся с нуля.

Подробная программа описывает темы, входные знания, результаты, лаборатории и роль схем. Ниже — карта уже написанных материалов. Основы JS/TS, FP, ADT и React вводятся отдельными главами; лаборатории связывают концепции с проверяемым поведением. Порядок бокового меню соответствует частям учебника. Редакционная готовность и проверки описывают границы этой версии.

I. Начало

• Быстрый старт: требования, запуск и первый рабочий цикл.
• Терминал, Git и первое изменение.
• Архитектура: приложения, границы и путь данных.

II–III. JavaScript, TypeScript и модели данных

• JavaScript: значения, функции и ссылки.
• TypeScript: типы и границы проверки.
• FP: преобразования и эффекты.
• ADT и runtime-валидация.
• Асинхронность: Promise, ошибки и отмена.
• Переходы состояния: reducer и машина состояний.

IV. React и состояние

• React: компоненты, JSX и композиция.
• React: события и владельцы состояния.
• React: формы, ошибки и доступность.
• React: эффекты и очистка подписок.
• Flux, useReducer и Context.
• Реактивность и FRP.
• Один фильтр: reducer, MobX, атомы и сигналы, включая URL, draft и persistence.

V. Интерфейс и UIKit

• HTML, DOM и CSS: семантика, layout, адаптивность и DevTools.
• UIKit и Storybook: тема, компоненты, композиция и документация.
• CSS-каскад: слои Mantine и локальная геометрия.
• API пакета и семь уроков Storybook.

VI. Next.js, рендеринг и кеширование

• CSR, SSR, SSG и ISR: место и время рендеринга, гидратация и Streaming.
• Ключи и уровни кеша: свежесть, HTTP-кеш и инвалидирование.
• Лаборатория гонок кеша: объединение промахов, поколения и ошибки.
• Лаборатория Suspense и streaming: оболочка до медленных данных.
• Сайт и Next.js: маршруты, серверные компоненты и оформление.
• SSG, ISR и 404: текущая генерация и ревалидация.

VII. HTTP, API и контракты

• HTTP: семантика и статусы: методы, ошибки и условное обновление.
• Повторы и идемпотентность: неизвестный результат, ключ операции и атомарность.
• REST, GraphQL, tRPC и gRPC: контракты, Protobuf и границы сравнения.
• API проекта: tRPC, Zod, webhook и проверки готовности.
• Origin, cookies, CORS и CSRF.
• OpenAPI, пагинация и совместимость.
• Один контракт через четыре API: исполняемые adapters и общая приёмка.

VIII. Модели данных и системы хранения

• SQL, NoSQL и NewSQL: модели, запросы и инварианты.
• PostgreSQL и JSONB: ограничения, SQL, версии и планы.
• Redis и роль кеша: структуры, TTL, отказы и устойчивость.
• ORM и смена СУБД: драйверы, TypeORM и переход с PHP/MySQL.
• OLTP, OLAP и столбцовое хранение: агрегации, копии и свежесть.
• MapReduce: локальная модель, частичные итоги и повторы задач.
• Векторный поиск: геометрия, точный baseline и оценка качества.
• Транзакции, конкуренция и устойчивый повтор.
• SQL, JSONB, Redis и TypeORM: лаборатории.
• Агрегации, столбцы, окна и ANN.
• Распределённый SQL: реплики, шарды, quorum и изоляция.
• Постепенный переход с PHP и MySQL/MariaDB.

IX. Strapi, контент и медиа

• Объектное хранение и S3: bucket, key, доступ и путь до браузера.
• Жизненный цикл медиа: загрузка, связи, публикация и восстановление.
• Практикум S3: Put/Get, presigned GET, multipart и abort.
• CMS и контент: модели, импорт, публикация и медиа.
• Вход и панели: доступ и настройки интерфейса.
• Обновление импортированного оформления.
• Медиабиблиотека: организация файлов и безопасные изменения.
• Задачи по расписанию: когда нужен cron; сейчас он не включён.
• Strapi и Garage: инструкции сервисов.

X. Инструменты, проверки и диагностика

• От исходника до запуска: компиляция, модули, workspace и редактор.
• Лаборатория проверок: типы, линтер, формат, runtime-вход и поведение.
• Отладчик и профилировщик.
• Проверки: typecheck, Oxlint, Oxfmt, Jest и границы покрытия.
• Лаборатория диагностики: различение гипотез, перцентили и агрегаты.
• Разбор проблем: симптомы, гипотезы и действия.

XI. DevOps и эксплуатация

• Git, worktree и три платформы.

• Релизные ветки и blue-green.

• Введение в DevOps.

• Linux, процессы, права и SSH.

• От образа до готового сервиса: probes, зависимости и границы релиза.

• DNS и TLS: имена, кеши, сертификаты и диагностика.

• Reverse proxy и HTTP/2–HTTP/3: Caddy, Host, rewrite и локальный опыт.

• Жизненный цикл PostgreSQL: init, соединения, WAL и восстановление.

• Миграции схемы и совместимость: expand/backfill/contract и границы отката.

• Docker и сеть.

• Настройки и секреты.

• Конфигурация своего экземпляра: identity, адреса и readonly проверка перед развёртыванием.

• CI/CD: проверки и артефакты: jobs, ref, digest, cache и полномочия.

• Лаборатория релиза: частичный успех, свидетельства и откат.

• SourceCraft CI и деплой.

• Публикация Storybook.

• Мониторинг и аналитика: конфигурация и выпуск стека.

• Наблюдаемость: логи, метрики, трассировки и цели качества.

• Резервные копии, восстановление и откат.

Практикум и справочник

• Сквозные задания.
• Команды, термины и источники.
• Ограничения и безопасность.

Устройство учебника

• Публикация документационного сайта.
• Редакционная готовность и проверки.
• Интерактивные главы MDX.

История проекта

Проектирование переноса, отчёт миграции, переименование VPS, сравнение 02.10 и сравнение 04.10 фиксируют результаты на конкретную дату. Они не заменяют актуальные инструкции; в поиске истории отведён отдельный переключатель.

Документация описывает код, а не подтверждает текущую публикацию на VPS. Изменения и учебные эксперименты выполняются в отдельной ветке и локальной среде.

Пилот перехода на другой Git-хостинг: SourceCraft.

Полные стенды SourceCraft: копия опубликованной CMS, собственные volumes, TTL, холодный режим и LRU.

Живая приёмка стендов: CI, HTTPS, сохранность данных и отзыв сертификатов.

Приёмка релизов и blue-green: код, CI и границы живой проверки.