1~
2При работе над сложными программными проектами выбор между monorepo и polyrepo может существенно повлиять на продуктивность вашей команды и масштабируемость кода. В этой статье мы анализируем различия, плюсы и минусы каждого подхода и помогаем вам понять, какой из них подходит именно вам.
3~
4## Что такое Monorepo и Polyrepo?
5~
6### Monorepo
7~
8**Monorepo** (монолитный репозиторий)  -  это единый репозиторий, содержащий исходный код нескольких проектов, сервисов или пакетов, часто связанных между собой.
9~
10```plaintext filename="Example Monorepo Structure"
11my-monorepo/
12  packages/
13    frontend/
14    backend/
15    shared/
16  package.json
17  turbo.json
18```
19~
20### Polyrepo
21~
22**Polyrepo** (множественные репозитории) означает, что каждый проект, сервис или пакет имеет собственный отдельный репозиторий.
23~
24```plaintext filename="Example Polyrepo Structure"
25repos/
26  frontend/
27    package.json
28  backend/
29    package.json
30  shared/
31    package.json
32```
33~
34## Визуальное различие
35~
36```mermaid
37flowchart TD
38    subgraph Monorepo
39        A1["frontend/"]
40        A2["backend/"]
41        A3["shared/"]
42    end
43    style Monorepo fill:#e0e7ff,stroke:#6366f1,stroke-width:2px
44```
45~
46```mermaid
47flowchart TD
48    subgraph Polyrepo
49        B1["frontend repo"]
50        B2["backend repo"]
51        B3["shared repo"]
52    end
53    style Polyrepo fill:#fee2e2,stroke:#ef4444,stroke-width:2px
54```
55~
56## Плюсы и минусы
57~
58### Monorepo
59~
60**Преимущества:**
61- Упрощает совместное использование кода (например, общие библиотеки).
62- Атомарный рефакторинг в нескольких проектах.
63- Централизованное управление зависимостями и конфигурациями.
64~
65**Недостатки:**
66- Может стать тяжёлым по мере роста кодовой базы.
67- Требует инструментов для управления частичными сборками/тестами (например, Nx, Turborepo).
68~
69### Polyrepo
70~
71**Преимущества:**
72- Каждая команда/проект независимы.
73- Проще управлять для небольших проектов.
74- Позволяет настраивать гранулярные политики доступа.
75~
76**Недостатки:**
77- Сложнее делиться кодом без публикации пакетов.
78- Кросс-репозиторный рефакторинг более сложен.
79- Возможное дублирование конфигураций.
80~
81## Практический пример: Monorepo с Turborepo
82~
83Предположим, вы хотите создать monorepo с frontend и backend с использованием Turborepo.
84~
85### 1. Инициализация monorepo
86~
87```bash
88npx create-turbo@latest
89```
90~
91### 2. Типичная структура
92~
93```plaintext
94my-monorepo/
95  apps/
96    web/        # frontend Next.js
97    api/        # backend Node.js/Express
98  packages/
99    ui/         # shared component library
100    utils/      # shared functions
101  turbo.json
102  package.json
103```
104~
105### 3. Пример workspace в `package.json`
106~
107```json
108{
109  "private": true,
110  "workspaces": [
111    "apps/*",
112    "packages/*"
113  ]
114}
115```
116~
117### 4. Пример импорта общей библиотеки
118~
119Предположим, у вас есть функция в `packages/utils/src/formatDate.ts`:
120~
121```ts
122// packages/utils/src/formatDate.ts
123export function formatDate(date: Date): string {
124  return date.toLocaleDateString('en-US');
125}
126```
127~
128Во frontend:
129~
130```ts
131// apps/web/pages/index.tsx
132import { formatDate } from '@myorg/utils';
133~
134export default function Home() {
135  return <div>Today is {formatDate(new Date())}</div>;
136}
137```
138~
139## Когда выбирать Monorepo?
140~
141- Средние и крупные команды, работающие над несколькими связанными проектами.
142- Необходимость совместного использования кода и масштабного рефакторинга.
143- Проекты, которые быстро растут и требуют оптимизированных сборок/тестов.
144~
145## Когда выбирать Polyrepo?
146~
147- Небольшие или независимые проекты.
148- Отдельные команды, работающие над разными продуктами.
149- Очень строгие политики доступа.
150~
151## Заключение
152~
153Идеального решения для всех не существует. Выбор зависит от размера команды, сложности проекта и потребностей в сотрудничестве. Важно осознавать компромиссы и выбирать правильные инструменты для управления сложностью.
154~