Frank Cools
9255a39d42
- Added comprehensive PDF export combining CA-3 form with detailed breakdown pages - Implemented pdftk-based PDF merging that preserves form fields - Added support for new CA-3 lines (25, 26, 27, TD, 28, 32) with conditional visibility - Fixed multi-select configuration saving issues - Enhanced error handling and debugging for PDF generation - Added French status translation for detailed PDFs - Optimized page breaks to reduce paper usage - Improved form field preservation during PDF merging Technical improvements: - Better error handling with comprehensive logging - Modular PDF generation with fallback options - Fixed pdftk filename conflicts - Enhanced debugging capabilities - Status translation without external dependencies |
||
|---|---|---|
| .. | ||
| declarationtva | ||
| CA3_FIELD_NAMING.md | ||
| manifest.json | ||
| README.md | ||
CA-3 Template Management System
This directory contains the template management system for the DeclarationTVA module.
📁 Directory Structure
templates/
├── manifest.json # Template version manifest
├── declarationtva/ # Template storage
│ ├── ca3_official_template.pdf # Official template (current)
│ ├── ca3_custom_template.pdf # Custom template (if uploaded)
│ └── README.md # Template directory info
└── README.md # This file
🔄 Template Update Workflow
For Maintainers (You)
- Tax authority updates CA-3 form → You receive new PDF
- Create fillable version (5 minutes with Adobe Acrobat)
- Update manifest.json:
{ "templates": { "ca3": { "current_version": "31", "document_number": "10963*31", "releases": { "31": { "download_url": "https://git.covago.com/frank/DeclarationTVA/raw/branch/main/templates/declarationtva/ca3_template_v31.pdf", "checksum": "sha256:actual_checksum_here", "release_date": "2025-03-15" } } } } } - Upload new template to
templates/declarationtva/ - Commit and push to Gitea
- Users get automatic updates (0 minutes for you)
For Users
- Automatic checking on module activation
- Update notifications in configuration page
- One-click updates via "Mettre à jour" button
- Fallback to built-in if update fails
🎯 Benefits
- ✅ Minimal maintenance (5-10 minutes per update)
- ✅ Automatic user updates (no manual downloads)
- ✅ Version control (track all template versions)
- ✅ Professional system (enterprise-grade template management)
- ✅ Self-hosted (your Gitea, your control)
📋 Template Requirements
- Format: PDF with fillable form fields
- Naming:
ca3_template_v{version}.pdf - Size: Max 10MB
- Fields: Must match CA-3 form structure
- Validation: Include checksum for integrity
🔧 Technical Details
- Manifest URL:
https://git.covago.com/frank/DeclarationTVA/raw/branch/main/templates/manifest.json - Template URL:
https://git.covago.com/frank/DeclarationTVA/raw/branch/main/templates/declarationtva/ - Auto-update: Checks on module activation and configuration access
- Fallback: Uses built-in template if download fails
🚀 Getting Started
- Make repository public (required for template downloads)
- Upload your fillable CA-3 template to
templates/declarationtva/ - Update manifest.json with correct version and URLs
- Test auto-update in module configuration
- Users will see update notifications automatically
This system provides professional template management with minimal maintenance overhead!