History

Frank Cools 18e5a68b7b Major CA-3 VAT Declaration Module Updates - Added comprehensive field naming documentation (CA3_FIELD_NAMING.md) - Implemented PDFTK-based PDF form filling with FDF generation - Added PDFTK installation guide for Linux/Mac/Windows - Enhanced PDF generation with company data integration - Added new CA-3 lines: F1, F2 (intracom acquisitions), E1-E6, F6-F8, line 18 - Updated section structure: merged Section C into Section B as sub-section - Added lines 19, 20 to TVA DÉDUCTIBLE sub-section - Updated all field descriptions to match official CA-3 form - Improved visual hierarchy with dark blue section headers - Enhanced calculation logic for VAT deductible amounts - Added comprehensive language translations - Updated database schema with new fields - Fixed font settings to use Courier New 9pt for official documents		2025-10-03 13:22:43 +02:00
..
declarationtva	Major CA-3 VAT Declaration Module Updates	2025-10-03 13:22:43 +02:00
CA3_FIELD_NAMING.md	Major CA-3 VAT Declaration Module Updates	2025-10-03 13:22:43 +02:00
manifest.json	🔄 Add Gitea-Based Template Auto-Update System	2025-10-03 00:17:59 +02:00
README.md	🔄 Add Gitea-Based Template Auto-Update System	2025-10-03 00:17:59 +02:00

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!