1~
2Cand lucrezi la proiecte software complexe, alegerea intre monorepo si polyrepo poate impacta semnificativ productivitatea echipei.
3~
4## Ce sunt Monorepo si Polyrepo?
5~
6### Monorepo
7~
8Un **monorepo** este un singur repozitoriu care contine codul sursa pentru mai multe proiecte.
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~
22Un **polyrepo** inseamna ca fiecare proiect are propriul sau repozitoriu separat.
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## Diferenta vizuala
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## Avantaje si dezavantaje
57~
58### Monorepo
59~
60**Avantaje:**
61- Faciliteaza partajarea codului.
62- Refactorizare atomica pe mai multe proiecte.
63- Gestionare centralizata a dependentelor.
64~
65**Dezavantaje:**
66- Poate deveni greu pe masura ce baza de cod creste.
67- Necesita instrumente pentru gestionarea build-urilor/testelor partiale (ex. Nx, Turborepo).
68~
69### Polyrepo
70~
71**Avantaje:**
72- Fiecare echipa/proiect este independent.
73- Mai usor de gestionat pentru proiecte mici.
74- Permite politici de acces granulare.
75~
76**Dezavantaje:**
77- Mai dificil de partajat cod fara publicarea de pachete.
78- Refactorizarea cross-repo este mai complexa.
79- Posibila duplicare a configuratiilor.
80~
81## Exemplu practic: Monorepo cu Turborepo
82~
83```bash
84npx create-turbo@latest
85```
86~
87```plaintext
88my-monorepo/
89  apps/
90    web/        # frontend Next.js
91    api/        # backend Node.js/Express
92  packages/
93    ui/         # biblioteca de componente partajata
94    utils/      # functii partajate
95  turbo.json
96  package.json
97```
98~
99```json
100{
101  "private": true,
102  "workspaces": [
103    "apps/*",
104    "packages/*"
105  ]
106}
107```
108~
109```ts
110// packages/utils/src/formatDate.ts
111export function formatDate(date: Date): string {
112  return date.toLocaleDateString('en-US');
113}
114```
115~
116```ts
117// apps/web/pages/index.tsx
118import { formatDate } from '@myorg/utils';
119~
120export default function Home() {
121  return <div>Today is {formatDate(new Date())}</div>;
122}
123```
124~
125## Cand sa alegi Monorepo?
126~
127- Echipe medii-mari care lucreaza pe proiecte conexe.
128- Nevoie de partajare a codului si refactorizare la scara larga.
129- Proiecte care cresc rapid.
130~
131## Cand sa alegi Polyrepo?
132~
133- Proiecte mici sau independente.
134- Echipe separate pe produse diferite.
135- Politici de acces foarte restrictive.
136~
137## Concluzie
138~
139Nu exista o solutie perfecta pentru toti. Alegerea depinde de dimensiunea echipei, complexitatea proiectului si nevoile de colaborare.
140~