Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Contributing to Conduction

Welkom bij de codebase van Conduction! We waarderen je bijdragen en hanteren een aantal richtlijnen om samenwerking soepel te laten verlopen. Lees dit document goed door voordat je een pull request (PR) indient.

## 🚀 Hoe Bijdragen

1. **Issues Checken**
- Controleer of er al een bestaand issue is voor je verandering.
- Als je een nieuw issue aanmaakt, gebruik de juiste labels en duidelijke titels.

2. **Werken met Git & Branches**
- Gebruik altijd feature branches (`feature/naam-van-feature`)
- Bugfixes op `bugfix/naam-van-bug`
- Release branches worden beheerd door de tech lead.

3. **Code Standaarden**
- Houd je aan **PSR-2** coding style.
- Documenteer code met **DocBlock** commentaar.
- Gebruik linting tools zoals ESLint en PHP-CS-Fixer waar nodig.

4. **Pull Requests (PRs)**
- Zorg dat je code werkt vóór je een PR indient.
- Voeg een beschrijving toe en link relevante issues.
- Laat minimaal één teamlid een review doen.
- Geen PR’s direct naar `main`! Gebruik `develop` als staging branch.

5. **Tests & Kwaliteit**
- Schrijf unit tests voor nieuwe functionaliteit.
- Code coverage moet minimaal **80%** zijn.
- Gebruik **Jest** voor frontend tests en **PHPUnit** voor backend tests.

6. **Beveiliging & Gevoelige Data**
- **NOOIT** API keys, wachtwoorden of tokens in de repo pushen.
- Zorg dat `.env` bestanden **niet** worden gecommit.
- Volg de beveiligingsrichtlijnen in `TEAM_MANIFESTO.md`.

## 🔗 Verdere Documentatie

- **Team werkafspraken & proces:** Zie [`TEAM_MANIFESTO.md`](TEAM_MANIFESTO.md)
- **Scrum & dagelijkse workflow:** Zie [`WORK_AGREEMENTS.md`](WORK_AGREEMENTS.md)

Bedankt voor je bijdrage! 🚀
38 changes: 38 additions & 0 deletions TEAM_MANIFESTO.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# 🏆 Team Manifesto - Conduction

Welkom bij Conduction! Dit document beschrijft de algemene teamafspraken en processen binnen onze organisatie.

## 🌍 Missie & Kernwaarden

Wij geloven in:
- **Democratie** – Iedereen heeft een stem in beslissingen.
- **Inclusiviteit** – Toegankelijkheid en respect voor iedereen.
- **Transparantie** – Open communicatie en heldere verwachtingen.

## 🔥 Algemene Werkafspraken

1. **Scrum & Agile**
- We werken in **sprints van 2 weken**.
- Refinements en planningen zijn verplicht.
- Issues zonder refinement worden **niet** opgepakt.

2. **Dagelijkse Rituelen**
- Stand-up om **10:00** – Verplicht tenzij expliciet afgemeld.
- Stand-down om **16:30** – Kort verslag in Slack.
- Sprint Review elke **2 weken** op vrijdag.

3. **Samenwerking & Communicatie**
- Feedback is **constructief en direct**.
- We gebruiken Slack voor dagelijkse communicatie.
- Jira is de **enige bron van waarheid** voor taken en voortgang.

4. **Beveiliging & Compliance**
- **Geen gevoelige data in repositories** (API keys, wachtwoorden).
- **VPN & BitLocker verplicht** bij remote werken.
- Security incidenten direct melden en escaleren.

5. **Verwijzing naar Gedetailleerde Afspraken**
- Voor technische bijdragen, zie [`CONTRIBUTING.md`](CONTRIBUTING.md).
- Voor dagelijkse workflow en tijdsregistratie, zie [`WORK_AGREEMENTS.md`](WORK_AGREEMENTS.md).

🚀 Laten we samen bouwen aan een sterk team en een geweldige organisatie!
35 changes: 35 additions & 0 deletions WORK_AGREEMENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# 📜 Work Agreements - Conduction

Dit document bevat de dagelijkse werkafspraken voor het development team van Conduction.

## 🔄 Scrum & Sprint Afspraken
- Sprints duren **2 weken**.
- Refinement is verplicht voordat een issue wordt opgepakt.
- Issues zonder duidelijke acceptatiecriteria worden **niet** ontwikkeld.
- Timeboxing: Duurt een issue langer dan gepland? **Escaleren in de stand-down**.

## ⏱ Tijdschrijven & Issue Management
- **Geen issue = geen werk** – alle taken moeten in Jira staan.
- Uren moeten **voor vrijdag 12:00** gelogd zijn in Tempo.
- Gebruik correcte **labels en story points** voor een realistische sprintplanning.
- Onvoorziene problemen worden **direct** gemeld in Slack en de volgende stand-up.

## 🔄 Pull Requests & Code Reviews
- Als een pull request wijzigingen vereist, is het aan de ontwikkelaar die de pull request heeft geopend, of de ontwikkelaar die de wijzigingen heeft aangebracht, om deze aan te passen.
- De reviewer of andere ontwikkelaars kunnen helpen bij het oplossen van de gevraagde wijzigingen, indien daarom wordt gevraagd door de ontwikkelaar die de pull request heeft geopend.

## 🛠 Dagelijkse Werkregels
- **Stand-up:** Elke werkdag om **10:00**, tenzij vooraf afgemeld.
- **Stand-down:** Dagelijkse update in Slack om **16:30**.
- **Sprint Review:** Presentatie van werk om de **2 weken op vrijdag**.

## 🔐 Beveiliging & Veilig Werken
- **NOOIT** API keys, wachtwoorden of gevoelige data in repositories pushen.
- **VPN verplicht** bij remote werken.
- Issues met security impact krijgen **directe prioriteit** en escaleren naar de tech lead.

## 📌 Verwijzingen
- Voor codebijdragen, zie [`CONTRIBUTING.md`](CONTRIBUTING.md).
- Voor algemene teamafspraken, zie [`TEAM_MANIFESTO.md`](TEAM_MANIFESTO.md).

🔹 Laten we samenwerken aan een efficiënte, veilige en plezierige werkomgeving!