#1988: README.md

projectforge-idp/README.md Path: plugins/org.projectforge.plugins.ihk/README.md · Lines: 20 · Type: Markdown documentation (German) 149 lines · 80 code · 26 comments · 43 blank

User-facing setup guide for the IHK plugin. Written in German — the plugin is specifically for the German IHK apprenticeship system (Ausbildungsnachweis — mandatory weekly reports that trainees submit to their training supervisor).

Plugin purpose

Exports weekly timesheet entries as a formatted Excel spreadsheet matching the IHK's required report format. Trainees enter their work hours in ProjectForge's timesheet; this plugin generates the weekly report Excel file that must be submitted to the IHK.

Configuration (JSON in address comment field)

The plugin reads configuration from the trainee's address book contact record — specifically the Bemerkungsfeld (comment/remark field). The JSON must be placed there:

{
  "ausbildungsbeginn" : "yyyy-mm-dd",
  "ausbildungsjahr" : "-1",
  "teamname" : "Dein Teamname"
}

Important constraint

The first and last name of the user must exactly match the first and last name in their address book contact record. The plugin matches timesheet entries by comparing the logged-in user's name to the contact's name.

Legacy note

This is one of the few remaining pure Java plugins in ProjectForge (see build.gradle.kts). Created by interns (mweishaar, jhpeters, mopreusser) in May 2020, based on earlier work by mnuhn (Dec 2019).