CI Biblija

Šta je ovo

Centralni CI/CD skript repo za sve Bitbucket pipeline-ove u InfoPuls-u. Ova biblije je kompas — odgovara na pitanja koja se najčešće gube u prelistavanju ci/ folder-stabla. Source of truth za svaku temu su ci/*/CLAUDE.md i docs/*.md.

Četiri ulaza — odaberi svoj

• Po ulozi

  ---

  JA SAM... Novi član tima · dev koji dodaje servis · onaj ko radi release · oncall 2am · reviewer · QA · onaj ko diže verziju biblije.

  Otvori v7.md §1 →

• Po pitanju

  ---

  PITANJE JE... Kako radi X · Zašto Y · Gdje da promijenim Z · Šta ako ne radi · Šta ako želim.

  Otvori v7.md §2 →

• Po sistemu

  ---

  SISTEM JE... Schemas · env vars · lock · fingerprint · sentry · arch graphs · vendor contract · state write protocol.

  Otvori 02-systems/ →

• Hitna pomoć

  ---

  GORI 2AM — Build je pao, deploy visi, pipeline ne vidi commit, output-var maskiran, Sentry ne stampa, arch drift.

  Otvori 04-incidents/ →

Knjige (po v7.md §1)

Knjiga	Za	Ključne stranice
📘 01-onboarding/	Novi član tima	welcome, folder tour, kako čitati, why-no-shell-tricks, vendor-auth-contract, why-not-env-file, make-canonical, pr-process, local-ci-parity
🛠️ 02-add-service/	Dev koji dodaje servis	(TBD)
⚙️ 02-verbs/	Verbs deep-dive	bump, deploy-coolify, deploy-ecs, deploy-eas, tag-fanout
🔧 02-systems/	Cross-section reference	13 stranica: schemas, env vars, lock, fingerprint, sentry, arch, vendor contract, state protocol
🚀 03-release/	Onaj ko radi release	Dva sanctioned patterna (single-run re-checkout, tag-triggered)
🌙 04-incidents/	Oncall 2am	build-failed, deploy-stuck, pr-pipeline-missing, sentry-missing, output-var-masked, arch-drift
👀 05-review/	Reviewer na PR-u	(TBD)
🧪 06-test/	QA / tester	(TBD)
📦 07-meta/	Onaj ko diže verziju biblije	(TBD)

Master TOC

Potpuni sadržaj biblije — svaki link, svaka sekcija, sve 25+ cross-ref stranica — u:

📑 v7.md

v7.md je kanonski master TOC (versionirani draft). Sadržaj biblije evoluira kroz verzije (v7 → v8 → ...).

Anti-pitanja (ovo NIJE biblije)

• ❌ "Kako se koristi X?" → idi u ci/<x>/CLAUDE.md, ne u bibliu.
• ❌ "Šta radi skripta Y?" → ci/<x>/CLAUDE.md + python3 ci/<x>/<y>.py --help.
• ❌ "Koja je razlika između v8 i v9?" → docs/history/.
• ❌ "Zašto baš ovako, a ne drugačije?" → ADR (docs/history/adr-*.md).
• ❌ "Mogu li dodati X u services.json?" → vidi 02-systems/02-services-json-map.md.

Pomoć

Ako ne nađeš odgovor u 30 sekundi:

1. Provjeri v7.md master TOC za deep reference.
2. Greška u biblii, ne u tebi — otvori PR ako misliš da nešto fali ili je netačno.
3. Operativna pitanja (zašto pipeline radi X) → odgovara odgovarajući ci/<x>/CLAUDE.md.

---

Ova biblije je u ranoj fazi. Trenutno ~20 strana popunjeno od predviđenih ~50. Svaka sekcija koja postoji odgovara na jedno pitanje, ne više. Cross-refs vode na canonical CLAUDE.md / docs.