Publieke Code

Publieke Code — Open Source Publicatie voor de Overheid

Publiceer overheidssoftware als open source conform de Standard for Public Code en Nederlandse richtlijnen.

Bron: Standard for Public Code | REUSE | developer.overheid.nl

Waarom publieke code?

Standard for Public Code — criteria

publiccode.yml

Elke publieke codebase bevat een publiccode.yml in de root van de repository:

publiccodeYmlVersion: "0.4"

name: Open Zaak
url: "https://github.com/open-zaak/open-zaak"
releaseDate: "2026-02-01"
developmentStatus: stable
softwareType: standalone/backend

description:
  nl:
    shortDescription: "Zaakregistratiecomponent conform ZGW API-standaarden"
    longDescription: >
      Open Zaak is een moderne, open-source implementatie van de
      ZGW API-standaarden voor zaakgericht werken bij gemeenten.
    documentation: "https://open-zaak.readthedocs.io/"
    features:
      - Zaken API
      - Documenten API
      - Catalogi API
      - Besluiten API
      - Autorisaties API

legal:
  license: EUPL-1.2
  mainCopyrightOwner: Dimpact
  repoOwner: open-zaak

maintenance:
  type: community
  contacts:
    - name: Maykin Media
      email: info@maykinmedia.nl

platforms:
  - web
  - linux

categories:
  - case-management
  - document-management

dependsOn:
  open:
    - name: Python
      versionMin: "3.10"
    - name: PostgreSQL
      versionMin: "14"
    - name: Redis

intendedAudience:
  countries:
    - nl
  scope:
    - government

localisation:
  localisationReady: true
  availableLanguages:
    - nl
    - en

REUSE-compliance

REUSE zorgt ervoor dat elke file in de repository duidelijke licentie-informatie heeft.

REUSE instellen

# Installeer de REUSE tool
pip install reuse

# Voeg licentie-headers toe aan alle bestanden
reuse annotate --license EUPL-1.2 --copyright "Gemeente Amsterdam" src/**/*.py

# Voeg de licentietekst toe
reuse download EUPL-1.2

# Controleer REUSE-compliance
reuse lint

Bestandsstructuur

project/
  LICENSES/
    EUPL-1.2.txt          # Volledige licentietekst
    CC-BY-4.0.txt         # Voor documentatie
    CC0-1.0.txt           # Voor configuratie/data
  .reuse/
    dep5                  # Bulk-licentie-toewijzing
  src/
    app.py                # SPDX header in elk bestand
  docs/
    handleiding.md        # CC-BY-4.0 licentie
  publiccode.yml
  README.md
  CONTRIBUTING.md
  CODE_OF_CONDUCT.md
  CHANGELOG.md

SPDX-headers

# SPDX-FileCopyrightText: 2026 Gemeente Amsterdam
# SPDX-License-Identifier: EUPL-1.2

"""Zaakregistratie module."""

.reuse/dep5 (bulk-toewijzing)

Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/

Files: *.json *.yaml *.yml *.toml
Copyright: 2026 Gemeente Amsterdam
License: EUPL-1.2

Files: docs/*
Copyright: 2026 Gemeente Amsterdam
License: CC-BY-4.0

Files: .gitignore .editorconfig
Copyright: 2026 Gemeente Amsterdam
License: CC0-1.0

Licentiekeuze

Waarom EUPL-1.2?

Repository-inrichting

Verplichte bestanden

GitHub repository template

# Security policy
cat > SECURITY.md << 'EOF'
# Security Policy

## Responsible Disclosure

Meld beveiligingsproblemen via [security@organisatie.nl](mailto:security@organisatie.nl).

Maak **geen** GitHub issue aan voor beveiligingsproblemen.

## Supported Versions

| Version | Supported |
|---------|-----------|
| 2.x     | Yes       |
| 1.x     | No        |

## Response Time

We streven ernaar om binnen 5 werkdagen te reageren.
EOF

CI/CD voor publieke code

# .github/workflows/public-code.yml
name: Public Code Compliance

on: [push, pull_request]

jobs:
  reuse:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: fsfe/reuse-action@v4

  publiccode:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Validate publiccode.yml
        uses: italia/publiccode-parser-action@v2
        with:
          publiccode: publiccode.yml

  standard-for-public-code:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Check Standard for Public Code
        run: |
          # Controleer verplichte bestanden
          for f in README.md LICENSE CONTRIBUTING.md CODE_OF_CONDUCT.md CHANGELOG.md publiccode.yml SECURITY.md; do
            if [ ! -f "$f" ] && [ ! -d "LICENSES" ]; then
              echo "ONTBREEKT: $f"
              exit 1
            fi
          done
          echo "Alle verplichte bestanden aanwezig"

Publicatie en vindbaarheid

Implementatie-checklist

• Repository publiek: code is openbaar op GitHub/GitLab
• Licentie: EUPL-1.2 (of Apache-2.0/MIT) toegepast
• REUSE-compliant: elke file heeft SPDX-header; reuse lint slaagt
• publiccode.yml: machine-leesbare metadata in repo-root
• README.md: doel, installatie, gebruik, bijdragen, licentie
• CONTRIBUTING.md: bijdrage-richtlijnen en review-proces
• CODE_OF_CONDUCT.md: gedragscode (Contributor Covenant)
• CHANGELOG.md: wijzigingslog (Keep a Changelog)
• SECURITY.md: responsible disclosure beleid
• CI/CD: pipeline die test, lint en valideert
• Code review: pull request vereist voor alle wijzigingen
• Catalogus: geregistreerd op developer.overheid.nl en/of softwarecatalogus
• Documentatie: installatie, configuratie, API-docs bijgewerkt

Gerelateerde skills

Meer informatie

• Standard for Public Code | Criteria
• Foundation for Public Code
• REUSE | REUSE FAQ
• EUPL-1.2
• publiccode.yml standaard
• developer.overheid.nl
• Joinup (EU) — Europees hergebruik platform
• Open Source beleid Rijksoverheid