rbsetiawan
/
LDAPWeb
1
0
Fork 0
Code Issues 2 Pull Requests Projects Releases Wiki Activity
GeoNetAgent, LDAPWeb, server-audit, server-connection
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
43 Commits
1 Branch
0 Tags
19 MiB
 
 
 
 
 
 
Tree: c958b343ed
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'c958b343ed'
${ noResults }
LDAPWeb/Workspace-Context.md

10 KiB
Raw Blame History

Workspace Context

Purpose

Dokumen ini adalah root context untuk seluruh workspace.

Workspace ini memiliki satu atau lebih repository.

Jangan melakukan analisis seluruh workspace sekaligus.

Selalu identifikasi repository yang relevan, kemudian baca docs/context-index.md pada repository tersebut sebagai sumber informasi utama.

Rules

  1. Selalu baca Workspace-Context.md terlebih dahulu.
  2. Tentukan repository yang relevan.
  3. Baca hanya docs/context-index.md pada repository tersebut.
  4. Ikuti seluruh referensi dokumentasi yang terdapat pada docs/context-index.md.
  5. Jangan membaca atau memodifikasi repository lain kecuali benar-benar dibutuhkan.
  6. Jika pekerjaan melibatkan lebih dari satu repository, baca docs/context-index.md masing-masing repository yang terkait.
  7. Jangan membuat asumsi mengenai arsitektur, API, database, server, maupun implementasi tanpa membaca dokumentasi repository terkait.

Repository Registry

Workspace ini berisi beberapa repository. Jangan analisis semuanya sekaligus — pilih yang relevan.

Repository Path lokal Git remote Cold start Peran
LDAPWeb (monorepo) D:\Project\app on git\ git.gisportal.id/rbsetiawan/LDAPWeb Workspace-Context.md Root workspace, navigasi lintas-repo
Mailcow Mailcow/ (monorepo) Mailcow/AGENTS.md Mail server sync.geonet.co.id
Ollama Ollama/ (monorepo) Ollama/AGENTS.md AI inference on-prem 10.100.1.26
Mikrotik Mikrotik/ (monorepo) Mikrotik/AGENTS.md Gateway NAT/firewall 10.100.1.1
GeoNetAgent GeoNetAgent/ (monorepo) GeoNetAgent/AGENTS.md Agent Windows + collector FastAPI
server-connection server-connection/ (monorepo) server-connection/AGENTS.md geonet-console, databaselist, sqlservercheck
Zammad Zammad/ (monorepo) Zammad/AGENTS.md Helpdesk zammad.gisportal.id
nginx nginx/ (monorepo) nginx/AGENTS.md Reverse proxy 10.100.1.24
Dockge Dockge/ (monorepo) Dockge/AGENTS.md Docker stack manager
ArcGIS Enterprise ArcGIS Enterprise/ (monorepo) ArcGIS Enterprise/AGENTS.md ESRI dev stack .51–.53
PC-Multimedia PC-Multimedia/ (monorepo) PC-Multimedia/AGENTS.md Workstation MULTIMEDIA 10.100.1.14
mysupperapps_FE_PWA mysupperapps_FE_PWA/ (gitignored) git.gisportal.id/rbsetiawan/mysupperapps-fe-pwa mysupperapps_FE_PWA/AGENTS.md FE PWA my.gisportal.id
AI-Agent-Standards AI-Agent-Standards/ (monorepo) AI-Agent-Standards/README.md SSOT template docs & handover
server-audit server-audit/ (monorepo) server-audit/AGENTS.md SSOT inventori server + SSH runbook
me me/ (monorepo) me/AGENTS.md Company profile PT. Multiatur + catatan kapabilitas (docs-only)

Catatan mysupperapps_FE_PWA:

  • Repo Git terpisah — folder lokal di-ignore di monorepo.
  • Cold start: mysupperapps_FE_PWA/AGENTS.md → docs/ai-session-summary.md
  • Backend API: server-connection/geonet-console (console.gisportal.id/api/v1).

Documentation Standard (SSOT)

Standar wajib: AI-Agent-Standards/prompts/bootstrap-new-project.md

Setiap repo wajib punya (minimum):

{repo}/AGENTS.md
{repo}/.env.example
{repo}/docs/version.md      ← append setiap deploy/perbaikan material
{repo}/docs/ai-session-summary.md
{repo}/docs/context-index.md
{repo}/docs/guide/migration.md
{repo}/docs/system-requirements.md
{repo}/docs/server.md

Version policy: setiap deploy, cutover, atau perbaikan material → append bullet poin di docs/version.md (jangan overwrite). Sinkron dengan changelog.md.

Cold start agent: AGENTS.md → docs/ai-session-summary.md → STOP (~2000 token).

Akhir sesi: AI-Agent-Standards/prompts/end-of-session-handover.md

Server Index (lintas project)

Host / IP Project Role Detail
10.100.1.1 Mikrotik Gateway, NAT, dual-WAN Mikrotik/docs/server.md
10.100.1.24 nginx, Dockge, server-connection, Zammad, GeoNetAgent Reverse proxy, Docker stacks nginx/docs/server.md
10.100.1.25 server-connection, GeoNetAgent PostgreSQL server-connection/docs/server.md
10.100.1.26 Ollama, server-connection AI inference (Ollama CPU) Ollama/docs/server.md
10.100.1.28 Mailcow, Dockge agent Mailcow VM Mailcow/docs/server.md
10.100.1.40 server-connection, Zammad, Mailcow Active Directory LDAP server-connection/docs/environment.md
10.100.1.51–.53 ArcGIS Enterprise ESRI dev ArcGIS Enterprise/docs/server.md
10.100.1.14 PC-Multimedia Workstation dev/GIS PC-Multimedia/docs/server.md
117.102.73.102 Mailcow, nginx IP publik NAT Mailcow/docs/server.md

Repository Ownership Policy

  • Setiap repository memiliki dokumentasi, aturan, dan lifecycle masing-masing.
  • Seluruh perubahan harus dilakukan pada repository yang benar.
  • Jangan membuat dokumentasi lintas repository yang menyebabkan duplikasi informasi.
  • Dokumentasi teknis harus tetap berada pada repository pemiliknya (Single Source of Truth).

Cross Repository Policy

Apabila sebuah pekerjaan melibatkan lebih dari satu repository:

  1. Identifikasi seluruh repository yang terdampak.
  2. Baca docs/context-index.md dari setiap repository terkait.
  3. Perbarui dokumentasi pada masing-masing repository yang mengalami perubahan.
  4. Dokumentasikan dependency dan integrasi antar repository apabila terjadi perubahan.
  5. Pastikan perubahan tetap kompatibel dengan repository lain.

Knowledge Preservation Policy

Setiap informasi yang diperoleh AI Agent selama proses:

  • Analisis
  • Debugging
  • Development
  • Testing
  • Deployment
  • Production Support
  • Incident Handling
  • Performance Tuning
  • Security Review

yang berpotensi berguna di masa depan harus didokumentasikan pada repository yang sesuai.

AI Agent tidak boleh menyimpan konteks penting hanya di dalam percakapan.

Seluruh pengetahuan yang relevan harus dipindahkan ke dokumentasi repository agar dapat digunakan kembali oleh developer maupun AI Agent lain.

Documentation Policy (Mandatory)

Seluruh repository merupakan Single Source of Truth untuk proses development, deployment, operasi, dan maintenance.

Dokumentasi merupakan bagian dari source code dan memiliki prioritas yang sama dengan implementasi.

Setiap perubahan wajib didokumentasikan.

Minimal dokumentasi yang harus diperbarui apabila relevan:

  • Feature Development
  • Enhancement
  • Bug Fix
  • Known Issues
  • Root Cause Analysis (RCA)
  • Technical Debt
  • TODO
  • Next Action
  • ADR (Architecture Decision Record)
  • Changelog
  • Version history (docs/version.md — append per deploy)
  • API Documentation
  • Database Structure
  • Database Migration
  • Environment Configuration
  • Infrastructure
  • Server Information
  • Deployment Guide
  • CI/CD
  • Monitoring
  • Logging
  • Dependency antar service
  • Breaking Changes
  • Security Notes
  • Workaround
  • Troubleshooting
  • Performance Optimization
  • Operational Notes
  • Catatan penting lainnya yang mempengaruhi proses development maupun deployment.

Documentation Quality Standard

Dokumentasi harus:

  • Akurat
  • Ringkas
  • Mudah dipahami
  • Selalu diperbarui
  • Tidak duplikat
  • Konsisten dengan implementasi kode
  • Menggunakan Markdown
  • Mengacu pada docs/context-index.md

Apabila dokumentasi sudah tersedia, lakukan pembaruan daripada membuat file baru.

AI Agent Responsibilities

Apabila AI Agent melakukan perubahan pada repository, maka AI Agent wajib:

  1. Memperbarui dokumentasi yang relevan.
  2. Memperbarui docs/context-index.md apabila terdapat dokumen baru.
  3. Memperbarui TODO apabila status berubah.
  4. Memperbarui Issue apabila ditemukan bug baru.
  5. Membuat ADR apabila terdapat keputusan arsitektur baru.
  6. Memperbarui dokumentasi API apabila endpoint berubah.
  7. Memperbarui dokumentasi database apabila schema berubah.
  8. Memperbarui deployment guide apabila proses deployment berubah.
  9. Memperbarui changelog untuk setiap perubahan penting.
  10. Memastikan seluruh dokumentasi konsisten dengan implementasi kode.
  11. Menandai dokumentasi yang sudah tidak berlaku sebagai Deprecated, bukan langsung menghapusnya.

Commit Policy

Sebelum pekerjaan dianggap selesai:

  • Review seluruh perubahan.
  • Pastikan dokumentasi telah diperbarui.
  • Pastikan tidak ada secret yang ikut ter-commit.
  • Pastikan repository dapat dibangun dan dijalankan apabila memungkinkan.
  • Buat commit yang jelas dan deskriptif.
  • Jangan melakukan commit yang mencampurkan perubahan yang tidak berkaitan.

Definition of Done (DoD)

Sebuah pekerjaan belum dianggap selesai apabila salah satu kondisi berikut masih ada:

  • Dokumentasi belum diperbarui.
  • TODO belum diperbarui.
  • Issue belum diperbarui.
  • API belum diperbarui.
  • ADR belum dibuat (jika diperlukan).
  • Changelog belum diperbarui.
  • docs/version.md belum di-append untuk deploy/perbaikan material.
  • docs/context-index.md belum diperbarui apabila terdapat dokumen baru.

Notes

  • Struktur workspace bersifat dinamis.
  • Repository dapat ditambah, dipindahkan, atau dihapus.
  • Pastikan daftar repository pada dokumen ini selalu diperbarui.
  • Seluruh dokumentasi teknis berada di masing-masing repository.
  • Workspace-Context.md hanya berfungsi sebagai navigasi dan entry point.
  • Selalu gunakan dokumentasi terbaru sebagai acuan sebelum melakukan analisis atau implementasi.
  • Prioritaskan pembaruan dokumentasi yang sudah ada daripada membuat dokumentasi baru yang berpotensi duplikat.