> ## Documentation Index
> Fetch the complete documentation index at: https://hyperlocalise.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Phát triển

> Phát triển và kiểm thử CLI hyperlocalise bằng Go.

## Điều kiện tiên quyết

* Go 1.26+
* `git`
* `make` có sẵn trong shell của bạn

## Sao chép kho lưu trữ

```bash theme={null}
git clone https://github.com/hyperlocalise/hyperlocalise.git
cd hyperlocalise
```

## Các công cụ và mô-đun Bootstrap

```bash theme={null}
make bootstrap
```

Thao tác này tải xuống các module Go và cài đặt bộ công cụ lint đã được ghim.

## Vòng lặp phát triển hằng ngày

```bash theme={null}
make fmt
make lint
make test
make check-build
```

## Chạy CLI cục bộ

```bash theme={null}
make run
# or
go run -ldflags "-X main.version=dev" ./apps/cli
```

## Cài đặt binary cục bộ

```bash theme={null}
make install
hyperlocalise version
```

## Các vị trí mã khóa

* `apps/cli/cmd/`: Các lệnh Cobra, cờ và hành vi đầu ra của CLI
* `pkg/i18nconfig/`: `i18n.yml` và `i18n.jsonc` phân tích cú pháp và xác thực
* `apps/cli/internal/i18n/runsvc/`: `run` lập kế hoạch và quy trình thực thi
* `apps/cli/internal/i18n/syncsvc/`: đồng bộ hóa điều phối và logic xung đột
* `internal/i18n/storage/`: hợp đồng adapter và tích hợp nhà cung cấp

## Trước khi mở một PR

```bash theme={null}
make precommit
```

Phần này chạy định dạng, lint, kiểm tra, và các kiểm tra build trong cùng luồng mà các cộng tác viên sử dụng.