Roosevelt Docs

Contributing

Code standards, review process en kwaliteitseisen

Contributing

Code Standards

Algemene Principes

  • Immutability — Nooit mutaten, altijd spread/create new objects
  • Kleine bestanden — 200-400 regels typisch, 800 max, organiseer per feature/domain
  • Functies — Max 50 regels, max 4 nesting niveaus
  • Validatie — Zod voor input op systeemgrenzen

Kwaliteitschecklist

  • Leesbare, goed benoemde code
  • Correcte error handling (try/catch met gebruiksvriendelijke messages)
  • Geen console.log, geen hardcoded waarden, geen mutatie
  • Security check: geen secrets, XSS, SQL injection

Pull Request Proces

  1. Branch aanmaken: feature/beschrijving of fix/beschrijving
  2. 4-gate pipeline doorlopen (Plan → TDD → Review → Commit)
  3. PR aanmaken met gh pr create
  4. Push Assessment doorlopen voor secrets en scope
  5. Review door code-reviewer agent + handmatige check

PR Template

## Summary
- Wat is er gebouwd/gefixed?
- Waarom is dit nodig?
 
## Test Plan
- [ ] Unit tests geschreven en geslaagd
- [ ] Integration tests geslaagd
- [ ] Handmatig getest op localhost
- [ ] Lighthouse score gecontroleerd
 
## Task
Plane: ROOSE-###

Testing Vereisten

  • Minimum coverage: 80%
  • TDD workflow: Schrijf test eerst (RED), dan implementatie (GREEN)
  • Test types: Unit + Integration + E2E (Playwright) voor kritieke flows
# Tests runnen
pnpm test
pnpm test:e2e
 
# Coverage rapport
pnpm test --coverage

On this page