satusehat-worker/scripts

🛠️ GoPrint Code Generator Tools

Kumpulan skrip otomatisasi (Code Generator) ini dirancang untuk mempercepat proses development aplikasi di ekosistem GoPrint. Dengan skrip ini, Anda dapat men-generate boilerplate (kode dasar) ratusan baris untuk arsitektur Clean Architecture, CQRS, REST API, dan gRPC secara instan.

Generator ini sangat cerdas, ia dapat membangun kode berdasarkan Skema Tabel Database (SQL) maupun Respons Payload (JSON) dari API pihak ketiga.

---

1. 🚀 Advanced Context Generator (context.sh)

Skrip utama (Swiss Army Knife) untuk men-generate seluruh lapisan modul aplikasi Anda.

Fitur Unggulan:

• 🧩 Dual Parser: Mendukung input dari file SQL (CREATE TABLE) maupun file JSON (Response API).
• 🔑 Dynamic Primary Key: Otomatis mendeteksi Primary Key tipe int64 maupun string/UUID dan menyesuaikan routing ID-nya.
• 🗑️ Smart Soft-Delete: Hanya membuat implementasi GORM Soft-Delete jika tabel/JSON tersebut benar-benar memiliki field deleted_at.
• 📁 Auto-Package Naming: Anda bebas meletakkan modul di path mana pun, nama package Go akan otomatis menyesuaikan nama folder terakhir.
• 📡 All-in-One Generation: Sekali klik langsung membuat: Entity, DTO, Mapper, Repository (CQRS), Service, REST Handler, Proto File, dan gRPC Handler.

📝 Aturan Penulisan (CLI Syntax):

./scripts/context.sh [OPTIONS]

Options:
  -s, --sql FILE         [Wajib*] Path ke file SQL yang berisi CREATE TABLE (Pilih salah satu dengan -j)
  -j, --json FILE        [Wajib*] Path ke file JSON payload response (Pilih salah satu dengan -s)
  -d, --dir PATH         [Wajib] Path destinasi modul/folder Anda (contoh: master/role)
  -t, --table NAME       [Opsional] Menimpa nama tabel secara manual (Sangat disarankan saat memakai -j)
  -g, --generate TYPE    [Opsional] Target generate: domain | handler | proto | grpc | all (Default: all)
  -v, --verbose          [Opsional] Tampilkan log proses secara mendetail
# Contoh menggunakan file users.sql dan disimpan di master/users
./scripts/context.sh -s db/migrations/users.sql -d master/users -g all

# Contoh riil menggunakan file role_pages.sql dan disimpan di master/role/pages
./scripts/context.sh -s internal/infrastructure/database/sql/00001_role_pages.sql -d master/role/pages -g all
# Contoh menggunakan file users.sql dan disimpan di master/users
./scripts/context.sh -s db/migrations/users.sql -d master/users -g all
./scripts/context.sh -s internal/infrastructure/database/sql/province.sql -d master/reference/province -g grpc
./scripts/context.sh -s db/migrations/users.sql -d master/users -v
internal/
└── master/
    └── reference/
        └── province/
            ├── dto.go                 # Struct Request & Response (Auto-validation tags)
            ├── entity.go              # GORM Struct (Auto DB tags)
            ├── repository.go          # CQRS Repository (Command & Query builder)
            ├── service.go             # Business Logic Layer
            ├── service_test.go        # Boilerplate Unit Test & Mocking
            └── mapper.go              # Logic konversi Entity <-> DTO

internal/
└── infrastructure/
    └── transport/
        ├── http/
        │   └── handlers/master/reference/province/
        │       └── province_handler.go # REST API Controller (Gin) dgn anotasi Swagger
        └── grpc/ 
            ├── handlers/master/reference/province/
            │   ├── province_grpc_handler.go
            │   └── province_grpc_mapper.go
            ├── proto/master/reference/province/v1/
            │   └── province.proto      # Schema antarmuka gRPC
            └── gen/master/reference/province/v1/
                └── ... (Hasil Compile .pb.go)
./scripts/proto.sh
./scripts/proto.sh internal/infrastructure/transport/grpc/proto/master/reference/province/v1
# 1. Mengecek daftar service yang terbuka (tes koneksi Server Reflection)
grpcurl -plaintext localhost:50051 list

# 2. Mengecek rincian method yang dimiliki oleh suatu service
grpcurl -plaintext localhost:50051 list master.v1.RoleAccessRolMasterService

# 3. Memanggil Method dengan mengirim Payload JSON
grpcurl -plaintext -d '{
  "id": 1
}' localhost:50051 master.v1.RoleAccessRolMasterService/GetRoleAccessRolMaster

<!--
[PROMPT_SUGGESTION]Bagaimana cara kerja fitur `-j` atau `--json` pada `context.sh` untuk mem-parsing payload API eksternal?[/PROMPT_SUGGESTION]
[PROMPT_SUGGESTION]Jelaskan alur registrasi handler REST dan gRPC di `main.go` setelah sebuah modul baru di-generate.[/PROMPT_SUGGESTION]
-->