Add job-search report templates, once the core lets a theme set the report #4

New issue

Open

opened 2026-10-01 07:02:05 +00:00 by tiagoagueda · 0 comments

tiagoagueda commented

2026-10-01 07:02:05 +00:00

Owner

The list asks for "Templates for job searching reports". The core draws its report from one fixed template, applications/report_print.html: A4, portrait, with the period, how regular the search was, what happened, the evidence table (applied on, company, role, found via, status, last activity) and the sources. It is filed as a document of kind report and handed to the document stores. No theme can set it: the report's kind is registered "laid out by its own print template rather than a theme" (src/postulo/documents/kinds.py in the core), and the wiki's Reports says "It has no template per country."

So this waits for postulo/postulo#340.

What the plugin should do

A report template in each family of #2, so a report handed over with a CV looks like it belongs with it.
One made for handing to an employment service: the evidence table first and complete, the person, the office and the adviser at the top (the core already records them, postulo/postulo#202), room for a date and a signature.
The evidence table is wide: a landscape variant, or a layout that survives portrait without cutting columns (#9).
Translations and assets as for every template (#7, #8).

Decisions

Forms per country. Employment services ask for different things. Recommended: one neutral hand-over template first; a country's own form is added when somebody who files it contributes it.
What a template may leave out. Recommended: a template lays out everything the core hands it and hides nothing; choosing what a report holds belongs on the report's page.

Needs from the core

postulo/postulo#340: a report kind for themes, a context of plain values, and somewhere to keep the choice. Until it lands the report keeps its one layout.

Done when

The report's page offers this plugin's templates, and the filed PDF is drawn by the one chosen.
The hand-over template shows every row of the period's evidence, in portrait and in landscape.

New strings go through uv run postulo-messages extract, with French and European Portuguese filled on the commit and the European Union catalogues before a tag, as in the other official plugins (#7).

From the list of template improvements of 2026-09-30.

The list asks for "Templates for job searching reports". The core draws its report from one fixed template, `applications/report_print.html`: A4, portrait, with the period, how regular the search was, what happened, the evidence table (applied on, company, role, found via, status, last activity) and the sources. It is filed as a document of kind report and handed to the document stores. No theme can set it: the report's kind is registered "laid out by its own print template rather than a theme" (`src/postulo/documents/kinds.py` in the core), and the wiki's *Reports* says "It has no template per country." So this waits for postulo/postulo#340. ## What the plugin should do - A report template in each family of #2, so a report handed over with a CV looks like it belongs with it. - One made for handing to an employment service: the evidence table first and complete, the person, the office and the adviser at the top (the core already records them, postulo/postulo#202), room for a date and a signature. - The evidence table is wide: a landscape variant, or a layout that survives portrait without cutting columns (#9). - Translations and assets as for every template (#7, #8). ## Decisions - **Forms per country.** Employment services ask for different things. Recommended: one neutral hand-over template first; a country's own form is added when somebody who files it contributes it. - **What a template may leave out.** Recommended: a template lays out everything the core hands it and hides nothing; choosing what a report holds belongs on the report's page. ## Needs from the core postulo/postulo#340: a report kind for themes, a context of plain values, and somewhere to keep the choice. Until it lands the report keeps its one layout. ## Done when - The report's page offers this plugin's templates, and the filed PDF is drawn by the one chosen. - The hand-over template shows every row of the period's evidence, in portrait and in landscape. New strings go through `uv run postulo-messages extract`, with French and European Portuguese filled on the commit and the European Union catalogues before a tag, as in the other official plugins (#7). From the list of template improvements of 2026-09-30.

tiagoagueda added the

enhancement

label

2026-10-01 07:02:05 +00:00

tiagoagueda referenced this issue

2026-10-01 07:02:07 +00:00

Say for every template whether it is fluid or restricted to a paper format, and hold it to that #9

tiagoagueda referenced this issue from Postulo/postulo

2026-10-01 07:02:07 +00:00

Let a theme set the job-search report: a report kind for themes, a context of plain values and a remembered choice #340

tiagoagueda referenced this issue

2026-10-30 21:25:23 +00:00