1 
2Apabila bekerja pada projek perisian yang kompleks, pilihan antara monorepo dan polyrepo boleh memberi kesan yang ketara terhadap produktiviti pasukan anda dan kebolehskalaan kod. Dalam artikel ini, kami menganalisis perbezaan, kebaikan dan keburukan setiap pendekatan, dan membantu anda memahami mana yang sesuai untuk anda.
3 
4## Apakah Monorepo dan Polyrepo?
5 
6### Monorepo
7 
8Sebuah **monorepo** (repositori monolitik) ialah satu repositori tunggal yang mengandungi kod sumber untuk pelbagai projek, perkhidmatan, atau pakej, yang sering berkaitan antara satu sama lain.
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 
22Sebuah **polyrepo** (pelbagai repositori) bermaksud setiap projek, perkhidmatan, atau pakej mempunyai repositori tersendiri yang berasingan.
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## Perbezaan Visual
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## Kebaikan dan Keburukan
57 
58### Monorepo
59 
60**Kelebihan:**
61- Memudahkan perkongsian kod (cth., pustaka kongsi).
62- Pemfaktoran semula atomik merentasi pelbagai projek.
63- Pengurusan berpusat bagi kebergantungan dan konfigurasi.
64 
65**Kelemahan:**
66- Boleh menjadi berat apabila pangkalan kod berkembang.
67- Memerlukan alat untuk menguruskan binaan/ujian separa (cth., Nx, Turborepo).
68 
69### Polyrepo
70 
71**Kelebihan:**
72- Setiap pasukan/projek adalah bebas.
73- Lebih mudah untuk diuruskan bagi projek kecil.
74- Membolehkan polisi akses yang terperinci.
75 
76**Kelemahan:**
77- Lebih sukar untuk berkongsi kod tanpa menerbitkan pakej.
78- Pemfaktoran semula merentas repositori lebih kompleks.
79- Kemungkinan pertindihan konfigurasi.
80 
81## Contoh Praktikal: Monorepo dengan Turborepo
82 
83Katakan anda ingin mencipta monorepo dengan frontend dan backend menggunakan Turborepo.
84 
85### 1. Mulakan monorepo
86 
87```bash
88npx create-turbo@latest
89```
90 
91### 2. Struktur biasa
92 
93```plaintext
94my-monorepo/
95  apps/
96    web/        # frontend Next.js
97    api/        # backend Node.js/Express
98  packages/
99    ui/         # pustaka komponen kongsi
100    utils/      # fungsi kongsi
101  turbo.json
102  package.json
103```
104 
105### 3. Contoh workspace dalam `package.json`
106 
107```json
108{
109  "private": true,
110  "workspaces": [
111    "apps/*",
112    "packages/*"
113  ]
114}
115```
116 
117### 4. Contoh import pustaka kongsi
118 
119Katakan anda mempunyai fungsi dalam `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 
128Dalam frontend:
129 
130```ts
131// apps/web/pages/index.tsx
132import { formatDate } from '@myorg/utils';
133 
134export default function Home() {
135  return <div>Hari ini ialah {formatDate(new Date())}</div>;
136}
137```
138 
139## Bila Memilih Monorepo?
140 
141- Pasukan sederhana hingga besar yang bekerja pada pelbagai projek berkaitan.
142- Perlu berkongsi kod dan melakukan pemfaktoran semula berskala besar.
143- Projek yang berkembang pesat dan memerlukan binaan/ujian yang dioptimumkan.
144 
145## Bila Memilih Polyrepo?
146 
147- Projek kecil atau bebas.
148- Pasukan berasingan yang bekerja pada produk berbeza.
149- Polisi akses yang sangat ketat.
150 
151## Kesimpulan
152 
153Tiada penyelesaian sempurna untuk semua orang. Pilihan bergantung pada saiz pasukan, kerumitan projek, dan keperluan kerjasama. Yang penting ialah menyedari pertukaran dan memilih alat yang betul untuk menguruskan kerumitan.
154