1~
2Kapag nagtatrabaho sa mga kumplikadong software project, ang pagpili sa pagitan ng monorepo at polyrepo ay maaaring malaki ang epekto sa produktibidad ng iyong team at scalability ng code. Sa artikulong ito, sinusuri namin ang mga pagkakaiba, kalamangan at kahinaan ng bawat approach, at tinutulungan kang maunawaan kung alin ang tama para sa iyo.
3~
4## Ano ang Monorepo at Polyrepo?
5~
6### Monorepo
7~
8Ang **monorepo** (monolithic repository) ay isang solong repository na naglalaman ng source code para sa maramihang proyekto, serbisyo, o package, madalas na magkakaugnay.
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~
22Ang **polyrepo** (maramihang repository) ay nangangahulugang ang bawat proyekto, serbisyo, o package ay may sariling hiwalay na repository.
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## Visual na Pagkakaiba
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## Mga Kalamangan at Kahinaan
57~
58### Monorepo
59~
60**Mga Kalamangan:**
61- Pinapadali ang code sharing (hal., shared library).
62- Atomic refactoring sa maraming proyekto.
63- Sentralisadong pamamahala ng mga dependency at configuration.
64~
65**Mga Kahinaan:**
66- Maaaring maging mabigat habang lumalaki ang codebase.
67- Nangangailangan ng mga tool para pamahalaan ang mga partial build/test (hal., Nx, Turborepo).
68~
69### Polyrepo
70~
71**Mga Kalamangan:**
72- Ang bawat team/proyekto ay independente.
73- Mas madaling pamahalaan para sa mga maliliit na proyekto.
74- Nagbibigay-daan sa mga granular na access policy.
75~
76**Mga Kahinaan:**
77- Mas mahirap magbahagi ng code nang hindi nagpapublish ng mga package.
78- Ang cross-repo refactoring ay mas kumplikado.
79- Posibleng duplication ng mga configuration.
80~
81## Praktikal na Halimbawa: Monorepo gamit ang Turborepo
82~
83Sabihin nating gusto mong gumawa ng monorepo na may frontend at backend gamit ang Turborepo.
84~
85### 1. I-initialize ang monorepo
86~
87```bash
88npx create-turbo@latest
89```
90~
91### 2. Karaniwang istruktura
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 function
101  turbo.json
102  package.json
103```
104~
105### 3. Halimbawa ng workspace sa `package.json`
106~
107```json
108{
109  "private": true,
110  "workspaces": [
111    "apps/*",
112    "packages/*"
113  ]
114}
115```
116~
117### 4. Halimbawa ng pag-import ng shared library
118~
119Sabihin nating may function ka sa `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~
128Sa frontend:
129~
130```ts
131// apps/web/pages/index.tsx
132import { formatDate } from '@myorg/utils';
133~
134export default function Home() {
135  return <div>Ngayong araw ay {formatDate(new Date())}</div>;
136}
137```
138~
139## Kailan Pipiliin ang Monorepo?
140~
141- Katamtaman hanggang malalaking team na nagtatrabaho sa maraming magkakaugnay na proyekto.
142- Pangangailangan na magbahagi ng code at magsagawa ng large-scale refactoring.
143- Mga proyektong mabilis na lumalaki at nangangailangan ng optimized na build/test.
144~
145## Kailan Pipiliin ang Polyrepo?
146~
147- Maliliit o independenteng proyekto.
148- Hiwalay na team na nagtatrabaho sa iba't ibang produkto.
149- Napakahigpit na access policy.
150~
151## Kongklusyon
152~
153Walang perpektong solusyon para sa lahat. Ang pagpipilian ay depende sa laki ng team, complexity ng proyekto, at mga pangangailangan sa collaboration. Ang mahalaga ay maging aware sa mga trade-off at pumili ng tamang mga tool para pamahalaan ang complexity.
154~