Files
govoplan-templates/README.md
T

1.5 KiB

GovOPlaN Templates

Repository type: module (domain).

govoplan-templates owns reusable renderable template definitions and render contracts for GovOPlaN. It is intentionally separate from reporting, DMS/files, mail delivery, forms runtime, and workflow state.

The first operational slice provides:

  • a scoped, versioned library for labels, label sheets, envelopes, serial and form letters, list layouts, email, and generic templates;
  • explicit usages, locales, required-field contracts, output profiles, and compatibility diagnostics;
  • safe deterministic HTML/text rendering from frozen caller-owned snapshots;
  • immutable template/input/output hashes, renderer version, item/page counts, diagnostics, and idempotent final-output evidence;
  • optional managed artifact persistence through the Core Files contract, with a bounded Templates download when Files is absent; and
  • a full-height library/editor/preview WebUI using the shared rich-text editor.

The module has no hard dependency on its consumers or on Files.

Development

cd /mnt/DATA/git/govoplan-templates
/mnt/DATA/git/govoplan/.venv/bin/python -m unittest discover -s tests
PATH=/mnt/DATA/git/govoplan-core/webui/node_modules/.bin:$PATH tsc -p webui/tsconfig.json --noEmit

See docs/TEMPLATE_BOUNDARY.md for the boundary decision.

User and administrator procedures are in docs/USER_GUIDE.md and docs/ADMIN_GUIDE.md.