Workflow contributions dla Open Core
Ten workflow jest dla kontrybutorów pracujących w publicznym repozytorium OpenArca.
1. Wybierz zakres
- Zacznij od issue/elementu roadmap z jasnymi kryteriami akceptacji.
- Utrzymuj jeden PR dla jednego problemu.
- Preferuj małe, reviewowalne przyrosty.
2. Utwórz branch
Rekomendowane nazewnictwo:
feat/<krótki-temat>fix/<krótki-temat>chore/<krótki-temat>
3. Implementuj z guardrails bezpieczeństwa
Nie wprowadzaj regresji w:
- kontrolach RBAC,
- ograniczeniach ownership,
- walidacji ścieżek zapisu,
- limitach uploadu,
- rate limitach.
4. Uruchom quality gates lokalnie
Backend:
cd backend
npm run lint
npm test
Frontend:
cd frontend
npm run lint
npm test
npm run build
Smoke stack:
docker compose up --build -d
docker compose ps
curl -s http://localhost:4000/health
5. Zweryfikuj kluczowe flow użytkownika
Minimum:
- logowanie OTP,
- tworzenie zgłoszenia,
- podgląd szczegółów zgłoszenia,
- zmiana statusu na Kanban,
- synchronizacja DevTodo,
- closure summary przed zamknięciem.
6. Styl commitów
Używaj conventional commits:
feat(scope): ...fix(scope): ...chore(scope): ...
7. Checklista pull requesta
- zakres jest jasny i ograniczony,
- testy przechodzą,
- wpływ migracyjny/operacyjny jest opisany,
- dokumentacja jest zaktualizowana przy zmianie zachowania.