# 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**:
   ```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!