De la cod la produs — ghid de învățare

Ghid personal pentru a duce cod din editor până la un produs care rulează în producție și poate fi operat. Scris pentru contextul real: self-hosted pe Contabo, Docker + Coolify/Traefik, fără GPU.

Cele 8 etape

1. Cod funcțional (MVP logic) — rezolvă problema într-un singur proces, fără infra. Dacă nu funcționează local, nu contează restul.

2. Versionare (git) — commit-uri mici, mesaje care spun „de ce", nu „ce". Un repo = un produs. Branch scurt, merge frecvent. Fără commit „WIP" care trăiește o săptămână.

3. Testare — unit pentru logică, integrare pentru frontiere. Regula: code owns the logic, LLM doar extrage. Testează determinismul, nu outputul frumos.

4. Containerizare (Docker) — un container = un proces = un responsabil. Imagine minimă, non-root, healthcheck. Volumul persistent e singurul lucru care contează la recreate.

5. Config & secrets — config în env, secret în env file/secrets manager, NICIODATĂ în cod sau în imagine. Default-uri sigure, override explicit.

6. Deploy (CI/CD) — pull + recreate e suficient la început. Automatizezi doar când deploy-ul manual doare. Rollback = tag anterior de imagine, nu „fix rapid în prod".

7. Observabilitate — logs structurate, health endpoint, o metrică de bază (erori/sec, latență). Alerta doar pe ce acționezi; restul e zgomot.

8. Iterare pe feedback real — produsul e judecat în producție, nu în demo. Colectează feedback, măsoară, taie ce nu se folosește.

Planul de cursuri în 4 faze

Faza 1 — Fundamente (2 săptămâni) - Shell, git (branch/merge/rebase), SSH. - Testare de bază: ce testezi, cum scrii un test care prinde un bug real. - Exercițiu: un script CLI cu teste, în git.

Faza 2 — Containerizare și medii (2 săptămâni) - Dockerfile, volume, networks, compose. - Medii: dev / staging / prod — ce diferă (config, secrets, date). - Exercițiu: împachetezi o aplicație existentă, o rulezi cu un DB într-un compose.

Faza 3 — Automatizare deploy (2 săptămâni) - CI/CD: build imagine → push → recreate. - Reverse proxy și TLS (Traefik/Coolify în cazul de față). - Exercițiu: un pipeline care duce un commit până la un subdomeniu HTTPS.

Faza 4 — Operare în producție (2 săptămâni, continuă) - Monitoring, loguri, incident response, backup/restore. - Cost și capacitate: când scalezi, când optimizezi, când nu. - Exercițiu: un incident simulat (DB plin, proces mort), rezolvat documentat.

Principii de-a lungul drumului

• Simple systems beat clever systems. Un singur API call e design corect; un orchestrator cu 5 servicii pentru un job simplu nu e.
• Edge cases fac parte din design, nu sunt curățenie. Inputul ilegibil pentru om e un rezultat valid, nu un eșec.
• Deliverable-ul numit — un tool/model/skill nou intră doar cu un deliverable și un proiect activ numit.

Legături: Skill vs Wiki — principiu de design agent · Zettelkasten — metoda (Ahrens) · GTD — metoda (David Allen) · Developer Tools