Welkom! Deze handleiding beschrijft hoe je kunt bijdragen aan het PMA project.
asd-pma/
Justfile # Hoofd taakdefinities
.env # Environment (niet committen!)
CLAUDE.md # AI instructies
scripts/
modules/ # Just modules per domein
common.just # Gedeelde helpers
imports.just # Module imports
redmine.just # Redmine commands
mattermost.just # Mattermost commands
*.py # Python utilities
packages/ # Service packages
redmine/
manifest.yaml # Service configuratie
mattermost/
docker/
docker-compose.yml # Docker service definities
.claude/
commands/ # AI Skills
install-service.md
add-sso.md
docs/ # Documentatie
WORKFLOW.md # Ticket workflow
# Service Commands
# ================
# Learnings:
# - Documenteer belangrijke bevindingen
# Start de service
service-start:
@echo "Starting service..."
docker compose up -d service
# Stop de service [group: lifecycle]
service-stop:
@echo "Stopping service..."
docker compose stop service
Regels:
[group: naam]#!/usr/bin/env python3
"""Script beschrijving."""
import argparse
import sys
def main():
"""Main entry point."""
parser = argparse.ArgumentParser(description="...")
# ...
if __name__ == "__main__":
main()
Regels:
feature/beschrijving # Nieuwe functionaliteit
fix/beschrijving # Bug fix
docs/beschrijving # Documentatie
refactor/beschrijving # Code refactoring
type(scope): korte beschrijving
Langere uitleg indien nodig.
Fixes #123
Types: feat, fix, docs, refactor, test, chore
## Samenvatting
Wat doet deze PR?
## Wijzigingen
- Wijziging 1
- Wijziging 2
## Test Plan
- [ ] Test 1
- [ ] Test 2
## Gerelateerd
Fixes #123
just package create myservice
Dit maakt:
packages/myservice/
manifest.yaml
name: myservice
display_name: "My Service"
description: "Beschrijving van de service"
version: "1.0.0"
profile: myservice
container: asd-myservice
ports:
main: 8080
volumes:
- myservice_data:/data
health:
type: http
endpoint: /health
expected_code: 200
sso:
type: oauth2
redirect_path: /callback
just package install myservice
Service Start
just start myservice
just status myservice # Moet "running" tonen
Health Check
just health myservice # Moet "healthy" tonen
Logs Check
just logs myservice # Geen errors
.claude/commands/mainZie FAQ voor antwoorden op veelgestelde vragen.