Processes
****# Available Processes
Index of all documented processes in Docling Studio. Each process is a structured, repeatable workflow with a clear trigger and deliverable.
Development
How to invoke
# Ask for a code review
Review cette PR avec docs/git-workflow/code-review-checklist.md
# Create an ADR
Crée un ADR pour [la décision à documenter]
Quality & Audit
How to invoke
# Full audit
Audite la branche release/X.Y.Z en suivant docs/audit/master.md
# Single audit
Exécute l'audit docs/audit/audits/08-security.md sur la branche courante
# Re-audit after fixes
Re-audite les écarts CRIT et MAJ du rapport docs/audit/reports/release-X.Y.Z/summary.md
# Automated checks (shell)
bash profiles/fastapi-vue/commands.sh
Release & Deploy
| # |
Process |
Trigger / Command |
Doc |
Output |
| 9 |
Release Gate |
Auto on push/PR release/* → main |
release-gate.yml |
GO / GO CONDITIONAL / NO-GO comment on PR |
| 10 |
Release |
Feature freeze on release/* |
CONTRIBUTING.md |
Tag vX.Y.Z, Docker images on ghcr.io |
| 11 |
Deployment |
After release tag |
deployment-checklist.md |
Running instance at new version |
| 12 |
Rollback |
Post-deploy failure detected |
rollback-playbook.md |
Reverted to last known good version |
| 13 |
Hotfix |
Critical bug on released version |
CONTRIBUTING.md |
Patch release vX.Y.Z+1 |
Release Gate details
The release gate runs automatically on every push to release/** and on PRs targeting main. It validates 10 checks in 4 phases:
Phase 1 (parallel) Phase 2 (Docker) Phase 3 (E2E) Phase 4
┌──────────────┐ ┌──────────────┐ ┌─────────────┐ ┌─────────────┐
│ lint+typecheck│ │ docker build │──────▶│ e2e API │───▶│ release │
│ unit tests │ │ docker smoke │──────▶│ e2e UI │ │ summary │
│ dep audit │ │ image scan │ └─────────────┘ │ (PR comment)│
│ audit checks │ │ image size │ └─────────────┘
└──────────────┘ └──────────────┘
| Check |
Blocks merge? |
Details |
| Lint & type-check |
Yes |
ruff + ESLint + vue-tsc |
| Unit tests |
Yes |
pytest + Vitest |
| Dep audit |
Yes (CRITICAL) |
pip-audit + npm audit |
| Audit checks |
Yes |
profiles/fastapi-vue/commands.sh |
| Docker build |
Yes |
Both targets (remote + local) |
| Docker smoke |
Yes |
Start container, verify /api/health |
| Image scan (Trivy) |
Yes (CRITICAL) |
HIGH = warning annotation |
| Image size |
No (warning) |
Delta vs previous release, alert if > 10% |
| E2E API |
Yes |
@smoke,@regression,@e2e (full scope) |
| E2E UI |
Yes |
@critical |
Verdict: posted as a comment on the release PR:
- GO — all checks pass
- GO CONDITIONAL — blocking checks pass, dep audit or audit checks have warnings
- NO-GO — at least one blocking check failed
How to invoke
# Release gate runs automatically — no manual trigger needed
# Just push to release/* or open a PR release/* → main
# Prepare a release
Prépare la release X.Y.Z en suivant CONTRIBUTING.md#release-process
# Deploy
Déploie en suivant docs/release/deployment-checklist.md
# Rollback
Rollback en suivant docs/release/rollback-playbook.md
Operations
How to invoke
# Incident
Gère l'incident SEV-1 en suivant docs/operations/incident-response.md
# Security vulnerability
Traite la vulnérabilité signalée en suivant docs/operations/security-response.md
How to invoke
# Triage issues
Trie les issues ouvertes en suivant docs/community/issue-triage-process.md
# Update roadmap
Mets à jour la roadmap en suivant docs/community/roadmap-template.md
Quick Reference
| Category |
Processes |
Key doc |
| Dev |
Commit, Review, Merge, ADR |
docs/git-workflow/ |
| Quality |
Audit (full/single/re-audit), Auto-checks |
docs/audit/master.md |
| Release |
Release, Deploy, Rollback, Hotfix |
docs/release/ + CONTRIBUTING.md |
| Ops |
Incident, Security, Monitoring |
docs/operations/ |
| Community |
Onboarding, Triage, Roadmap |
docs/community/ |
Standards & References
These are not processes but reference documents used by the processes above: