Deployment Situs Dokumentasi — docs.gcgscola.id¶

Last verified: 2026-06-13 (Fase 3 — dev-docs.gcgscola.id)
URL publik: https://docs.gcgscola.id
URL implementor: https://implement.gcgscola.id
URL developer: https://dev-docs.gcgscola.id
Stack: MkDocs Material → static HTML → nginx + Cloudflare Access

1. Tier Dokumentasi¶

Tier	Config	Audience	Auth	Deploy path
Publik	`mkdocs-public.yml` / `mkdocs.yml`	End user	Tidak	`/var/www/docs.gcgscola.id`
Implementor	`mkdocs-internal.yml`	Go-live, config, UAT klien	Cloudflare Access (partner + GCG)	`/var/www/implement.gcgscola.id`
Developer	`mkdocs-developer.yml`	QA, SSOT, audit, AI agent	Cloudflare Access (@gcgscola.id)	`/var/www/dev-docs.gcgscola.id`

SSOT tetap satu folder docs/ di repo.

2. Subdomain¶

Subdomain	Status	Konten
docs.gcgscola.id	Aktif	`user-guide/**`
implement.gcgscola.id	Aktif	`operations/**` (config guides, playbook, UAT)
dev-docs.gcgscola.id	Aktif (Fase 3)	`qa/`, `ai-guidelines/`, `domains/`, `audit/`, arsitektur

3. Arsitektur¶

docs/
  → mkdocs-public.yml    → docs.gcgscola.id       (publik)
  → mkdocs-internal.yml  → implement.gcgscola.id  (Access: partner + GCG)
  → mkdocs-developer.yml → dev-docs.gcgscola.id   (Access: GCG only)

Branding & Open Graph: docs/assets/branding/, docs/overrides/main.html

4. Build & Deploy¶

cd /home/scola/odoo/scola-fe-v2

./scripts/build-docs.sh public --install      # end user
./scripts/build-docs.sh internal --install    # implementor
./scripts/build-docs.sh developer --install   # dev/QA
./scripts/build-docs.sh all --install         # ketiga sekaligus

Backward compatible: ./scripts/build-docs.sh --install = public --install.

Setelah edit…	Perintah
`docs/user-guide/`	`public --install`
`docs/operations/`	`internal --install`
`docs/qa/`, `domains/`, `audit/`, `ai-guidelines/`	`developer --install`

5. Cloudflare Access¶

Subdomain	Panduan	Policy disarankan
implement.gcgscola.id	docs-implementor-access.md	`@gcgscola.id` + partner implementor
dev-docs.gcgscola.id	docs-developer-access.md	`@gcgscola.id` only

SSL/TLS Cloudflare: Full (strict) untuk semua subdomain docs.

6. Nginx + SSL (pertama kali per subdomain)¶

# Implementor
sudo cp config/nginx/implement.gcgscola.id.http-only.conf /etc/nginx/sites-enabled/implement.gcgscola.id
sudo certbot --nginx -d implement.gcgscola.id

# Developer
sudo cp config/nginx/dev-docs.gcgscola.id.http-only.conf /etc/nginx/sites-enabled/dev-docs.gcgscola.id
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d dev-docs.gcgscola.id

# Publik
sudo cp config/nginx/docs.gcgscola.id.http-only.conf /etc/nginx/sites-enabled/docs.gcgscola.id
sudo certbot --nginx -d docs.gcgscola.id

Template HTTPS: config/nginx/*.conf di repo config/nginx/.

7. File Terkait¶

File	Fungsi
`mkdocs-public.yml`	Portal end user
`mkdocs-internal.yml`	Portal implementor
`mkdocs-developer.yml`	Portal developer/QA
`scripts/build-docs.sh`	Build multi-tier
`docs/index.md`	Beranda publik
`docs/internal/index.md`	Beranda implementor
`docs/developer/index.md`	Beranda developer
`docs/assets/branding/`	Logo, favicon, OG image
`docs/overrides/main.html`	Open Graph / Twitter Card