# Push ke Git — LDAPWeb Monorepo

> Panduan push ke [git.gisportal.id](https://git.gisportal.id/) · akun **rbsetiawan** · repo **LDAPWeb**

## Info repository

| Item | Nilai |
|------|-------|
| Remote | `https://git.gisportal.id/rbsetiawan/LDAPWeb.git` |
| Branch default | `master` |
| Root lokal | `D:\Project\app on git` |
| Web | https://git.gisportal.id/rbsetiawan/LDAPWeb |

### Folder di-ignore (tidak ikut push)

- `ops/`
- `support/`
- `support-api/`
- `LDAPWeb.code-workspace`
- `.env` (kecuali `*.env.example`)
- `node_modules/`, `.venv/`, `GeoNetAgent/agent/config.json`

`support/` dan `support-api/` punya repo Git terpisah di akun lain — jangan di-push dari monorepo ini.

---

## Perintah langsung ke Agent

Salin blok di bawah ke chat Cursor bila ingin Agent melakukan push:

```
Push perubahan ke git.gisportal.id (rbsetiawan/LDAPWeb).
Ikuti push.md: cek status, pastikan tidak ada .env/secret, commit dengan pesan jelas, lalu push origin master.
Jangan push folder yang di-ignore (.gitignore).
```

### Variasi perintah

| Tujuan | Perintah ke Agent |
|--------|-------------------|
| Push semua perubahan | `Commit dan push semua perubahan ke origin master sesuai push.md` |
| Push satu folder | `Commit dan push hanya perubahan di GeoNetAgent/ ke origin master` |
| Push setelah sync docs | `Update dokumentasi .cursor lalu commit & push sesuai push.md` |
| Cek sebelum push | `Jalankan pre-push checklist di push.md, laporkan hasil tanpa push` |

---

## Perintah manual (PowerShell)

### 1. Masuk ke root proyek

```powershell
cd "D:\Project\app on git"
```

### 2. Cek perubahan

```powershell
git status
git diff
git diff --staged
```

### 3. Stage file

```powershell
# Semua perubahan (hormati .gitignore)
git add .

# Atau per folder
git add GeoNetAgent/
git add LDAPWeb/
git add server-audit/
git add server-connection/
```

### 4. Commit

```powershell
git commit -m "feat(GeoNetAgent): deskripsi singkat perubahan"
```

Contoh pesan commit:

```powershell
git commit -m "docs: sinkronkan .cursor setelah sesi pengembangan"
git commit -m "fix(LDAPWeb): perbaiki validasi login LDAP"
git commit -m "chore: update nginx config collector"
```

### 5. Push

```powershell
git push origin master
```

Atau (jika upstream sudah di-set):

```powershell
git push
```

### 6. Verifikasi

```powershell
git status
git log -1 --oneline
```

---

## Checklist Agent sebelum push

Agent **wajib** memeriksa ini sebelum `git commit` / `git push`:

1. **Tidak ada secret** — pastikan `.env`, password, token, atau kredensial tidak ter-stage.
2. **Hormati `.gitignore`** — jangan paksa-add `ops/`, `support/`, `support-api/`.
3. **Dokumentasi** — jika ada perubahan arsitektur/desain, update `.cursor/*.md` atau ADR dulu (lihat `GeoNetAgent/perintah.md`).
4. **Pesan commit** — jelas, menyebut area (`GeoNetAgent`, `LDAPWeb`, dll.) dan alasan singkat.
5. **Branch** — push ke `master` kecuali user minta branch lain.
6. **Jangan** `git push --force` ke `master` tanpa persetujuan eksplisit user.

---

## Troubleshooting

### Autentikasi gagal

```powershell
git remote -v
git push origin master
```

Credential Windows Credential Manager: host `git.gisportal.id`, user `rbsetiawan`.

### Remote belum ada

```powershell
git remote add origin https://git.gisportal.id/rbsetiawan/LDAPWeb.git
git push -u origin master
```

### Push ditolak (behind remote)

```powershell
git pull origin master
# selesaikan konflik jika ada, lalu:
git push origin master
```

Lihat juga: [pull.md](pull.md)

### File besar / push lambat

`server-connection/databaselist/vendor/` ikut repo — hindari commit ulang vendor tanpa perlu.

---

## Alur singkat (Agent)

```mermaid
flowchart LR
  A[git status] --> B{Ada secret?}
  B -->|Ya| C[Stop — perbaiki .gitignore]
  B -->|Tidak| D[git add]
  D --> E[git commit]
  E --> F[git push origin master]
  F --> G[git status — up to date]
```