Logo

CopyPastWorld

Обучение программированию

Fullstack-разработчик на TypeScript: Next.js, PostgreSQL и Production SaaS

Next.js: от React-приложения к fullstack framework

1/189
🎁
1-й урок без регистрации • 1-й модуль в подарок
Зарегистрируйтесь бесплатно — сохраните прогресс и откройте весь 1-й модуль каждого курса в подарок без оплаты подписки.
Открыть 1-й модуль бесплатно
Теория + Тест + Практика

Next.js: от React-приложения к fullstack framework

15 мин25 баллов

В этом курсе мы выходим на уровень fullstack-разработки на TypeScript. Вы уже умеете создавать приложения на React и TypeScript, работать с компонентами, состоянием, маршрутизацией, HTTP и API.

Теперь задача меняется.

Нам нужен не только интерфейс в браузере, но приложение, которое умеет выполнять часть работы на сервере:

  • получать данные до отправки страницы пользователю;
  • обращаться к защищённым источникам данных;
  • формировать маршруты без ручной настройки router;
  • выполнять серверные операции;
  • отдавать HTTP endpoints;
  • управлять loading и error states;
  • собираться и запускаться как единое fullstack-приложение.

Для этого мы будем использовать Next.js.

Главная идея урока:
Next.js не заменяет React. React отвечает за модель пользовательского интерфейса, а Next.js добавляет framework-уровень: маршрутизацию, серверное выполнение, загрузку данных, HTTP-возможности и соглашения для построения полноценного web-приложения.


React и framework решают разные задачи

React позволяет описывать UI через компоненты:

type Task = {
  id: string;
  title: string;
};

export function TaskCard({
  task,
}: {
  task: Task;
}) {
  return (
    <article>
      <h2>{task.title}</h2>
    </article>
  );
}

React хорошо отвечает на вопросы:

  • как разбить интерфейс на компоненты;
  • как передавать props;
  • как хранить локальное состояние;
  • как реагировать на события;
  • как обновлять UI при изменении данных.

Но полноценному приложению нужно значительно больше.

Например:

/tasks
/tasks/new
/tasks/task-42
/tasks/task-42/edit

Нужно определить:

  • какой URL соответствует какой странице;
  • где загружать данные;
  • какой код должен выполняться на сервере;
  • какой код нужен браузеру;
  • что показать во время загрузки;
  • как обработать отсутствующий ресурс;
  • как вернуть HTTP-response;
  • как подготовить production build.

В обычном React SPA эти задачи собираются из отдельных решений:

React
+ router
+ data fetching
+ build tool
+ backend API
+ deployment configuration

Это нормальная архитектура. Next.js предлагает другую модель:

React
↓
Next.js
├── routing
├── server rendering
├── server data loading
├── client interactivity
├── HTTP endpoints
└── production conventions

Поэтому Next.js правильнее воспринимать не как «улучшенную версию React», а как framework вокруг React. React остаётся внутри.


Почему одного client-side rendering бывает недостаточно

Классическое SPA часто стартует с небольшого HTML:

<!doctype html>
<html lang="ru">
  <body>
    <div id="root"></div>
    <script type="module" src="/src/main.tsx"></script>
  </body>
</html>

После загрузки JavaScript React создаёт интерфейс в браузере.

Упрощённо:

Browser
↓
HTML
↓
JavaScript
↓
React
↓
API requests
↓
UI

Такой подход называется client-side rendering (CSR). Для множества продуктов он полностью подходит (например, внутренний dashboard после входа пользователя может прекрасно работать как SPA).

Но теперь представим публичную страницу:

/products/nextjs-course

Для неё могут быть важны:

  • первоначальный HTML с содержимым;
  • metadata;
  • быстрый первый показ;
  • загрузка данных на сервере;
  • отсутствие необходимости отдавать browser часть серверных credentials.

Или страница приложения должна получить данные напрямую из PostgreSQL. Плохая идея:

Browser
↓
PostgreSQL (Database credentials нельзя отдавать клиенту!)

Нужна надёжная серверная граница:

Browser
↓
Next.js server
↓
PostgreSQL

Next.js позволяет React-приложению естественно работать и на клиентской, и на серверной стороне. Это не означает, что всё нужно рендерить на сервере или что CSR больше не нужен.

Современное приложение часто является гибридным:

  • server → данные и первоначальная структура
  • client → интерактивность

Именно эту границу мы будем изучать на протяжении всего курса.


App Router превращает файловую структуру в маршруты

В обычном SPA маршрут часто объявляется программно:

/tasks
→ TasksPage

/tasks/new
→ NewTaskPage

/tasks/:taskId
→ TaskPage

В Next.js App Router структура маршрутов задаётся каталогами. Например:

app/
├── page.tsx
└── tasks/
    ├── page.tsx
    ├── new/
    │   └── page.tsx
    └── [taskId]/
        ├── page.tsx
        └── edit/
            └── page.tsx

Из неё получаются маршруты:

ФайлURL
app/page.tsx/
app/tasks/page.tsx/tasks
app/tasks/new/page.tsx/tasks/new
app/tasks/[taskId]/page.tsx/tasks/task-42
app/tasks/[taskId]/edit/page.tsx/tasks/task-42/edit

Каталог [taskId] обозначает динамический segment. Поэтому один маршрут /tasks/[taskId] может обслуживать /tasks/task-1, /tasks/task-42, /tasks/task-900.

URL становится частью структуры приложения, а routing — framework convention.


Server Components и Client Components разделяют ответственность

Одна из ключевых идей App Router — React-компонент необязательно должен выполняться в браузере. По умолчанию компоненты в App Router являются Server Components.

Например страница списка:

export default async function TasksPage() {
  const tasks = await getTasks();

  return (
    <main>
      <h1>Tasks</h1>

      <ul>
        {tasks.map((task) => (
          <li key={task.id}>
            {task.title}
          </li>
        ))}
      </ul>
    </main>
  );
}

Здесь компонент может получить данные непосредственно в серверной части приложения. Нам не обязательно строить классическую цепочку render empty component → useEffect → fetch → loading state → setState → second render.

Для серверной страницы возможно: request → load data on server → render → response.

Но Server Component не заменяет клиентскую интерактивность. Представим поиск, который пользователь меняет прямо в интерфейсе:

'use client';

import { useState } from 'react';

export function TaskSearch() {
  const [query, setQuery] = useState('');

  return (
    <label>
      Поиск
      <input
        value={query}
        onChange={(event) => {
          setQuery(event.target.value);
        }}
      />
    </label>
  );
}

Здесь нужен useState, onChange и браузерные события, поэтому это Client Component.

Получается важная граница:

  • Server Component → server data, server-only dependencies, первоначальный UI
  • Client Component → events, local state, browser APIs, интерактивность

Какая часть конкретного пользовательского сценария действительно должна выполняться в браузере?
По умолчанию сохраняйте серверную часть серверной и добавляйте 'use client' только там, где появляется реальная интерактивная необходимость.


Когда Next.js оправдан

Next.js подходит не потому, что «сейчас модно писать на Next.js». Framework должен решать реальные задачи продукта.

Рассмотрим три приложения:

  1. Внутренний dashboard: Пользователь всегда авторизован, SEO не требуется, интерфейс очень интерактивный. Такой продукт вполне может оставаться обычным React SPA.
  2. Публичный каталог: Есть страницы продуктов, metadata, публичные URL, server data и требования к первоначальной загрузке. Next.js здесь даёт максимальные преимущества.
  3. SaaS-приложение: Есть публичный landing, authentication, dashboard, database, server mutations, API, metadata, account settings. Это эталонный пример гибридного приложения, где framework позволяет держать публичные, серверные и интерактивные части в единой архитектуре.

Дальше мы постепенно пройдём путь:

React UI
↓
Next.js routing
↓
Server Components
↓
server data
↓
mutations
↓
HTTP
↓
PostgreSQL
↓
authentication
↓
production SaaS

Next.js здесь — не конечная цель, а framework foundation, поверх которого мы будем строить весь дальнейший fullstack stack.


Практическое задание

Создайте первое Next.js-приложение на TypeScript с App Router.

Задание 1. Структура маршрутов

Приложение должно поддерживать:

  • / — главная страница
  • /tasks — список задач
  • /tasks/new — форма создания
  • /tasks/[taskId] — просмотр конкретной задачи
  • /tasks/[taskId]/edit — редактирование задачи

Задание 2. Серверная страница списка

Создайте серверную страницу app/tasks/page.tsx, получающую данные напрямую через асинхронную функцию getTasks() без использования useEffect.

Задание 3. Изоляция интерактивности (Client Boundary)

Вынесите интерактивную строку поиска TaskSearch в отдельный клиентский компонент с директивой 'use client', сохранив родительскую страницу TasksPage серверной.

Задание 4. Сравнение архитектур

Сравните обязанности и возможности классического React SPA и Next.js App Router (роутинг, загрузка данных, серверный код, интерактивность, API).

Вопрос 1

Как точнее всего описать отношение Next.js и React?

Вопрос 2

Какие возможности Next.js добавляет поверх React?

Вопрос 3

Что означает CSR?

Вопрос 4

Какой маршрут создаёт файл app/tasks/page.tsx?

Вопрос 5

Что означает каталог [taskId]?

Вопрос 6

Какие задачи естественно выполнять в Server Component?

Вопрос 7

Когда нужен Client Component?

Вопрос 8

Нужно ли превращать всю страницу в Client Component, если один input использует useState?

Вопрос 9

Какие приложения могут получить особенно заметную пользу от Next.js?

Вопрос 10

Какой принцип лучше использовать при разделении server/client responsibility?

Серверная страница и клиентская граница в Next.js

Реализуйте серверную страницу TasksPage с загрузкой данных и изолированный клиентский компонент TaskSearch с поисковым input.

Загрузка песочницы...

Ваш прогресс в уроке

Выполняйте задания, чтобы заработать все баллы

Теория
25 баллов
Тесты
0/ 10
Практика
0/ 20
Текущий результат:
25/ 55 баллов