DeclarationTVA/templates

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)

1. Tax authority updates CA-3 form → You receive new PDF
2. Create fillable version (5 minutes with Adobe Acrobat)
3. 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"
           }
         }
       }
     }
   }
   

4. Upload new template to templates/declarationtva/
5. Commit and push to Gitea
6. 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

1. Make repository public (required for template downloads)
2. Upload your fillable CA-3 template to templates/declarationtva/
3. Update manifest.json with correct version and URLs
4. Test auto-update in module configuration
5. Users will see update notifications automatically

This system provides professional template management with minimal maintenance overhead!