DeclarationTVA/ChangeLog.md

# CHANGELOG MODULE DECLARATIONTVA FOR [DOLIBARR ERP CRM](https://www.dolibarr.org)

## 2.5.27

### Bug Fixes
- **Removed Debug Code**: Cleaned up all debug statements and error_log calls from PDF generation
- **Cleaner Codebase**: Removed test data and debugging code for production readiness
- **Improved Performance**: Eliminated unnecessary logging during PDF generation
- **Production Ready**: Code is now clean and optimized for production use

## 2.5.26

### Bug Fixes
- **Added Declaration Period to Footer**: Footer now displays declaration period centered between company name and page number
- **Enhanced Footer Information**: Footer now shows company name, declaration period, and page count
- **Professional PDF Layout**: Complete footer with all relevant information
- **Better Document Identification**: Declaration period helps identify the document period

## 2.5.25

### Bug Fixes
- **Fixed Footer Page Count with Alias System**: Now uses TCPDF's alias system for proper total page count
- **Correct Page Display**: Footer now shows proper "Page X/Y" format with accurate total pages
- **Professional PDF Layout**: Fixed issue where total pages were showing as current page
- **Accurate Page Information**: Footer now displays correct total page count using getAliasNbPages() method

## 2.5.24

### Bug Fixes
- **Fixed Footer Page Count Implementation**: Now properly sets total pages after all pages are generated
- **Correct Page Display**: Footer now shows proper "Page X/Y" format with accurate total pages
- **Professional PDF Layout**: Fixed issue where {nb} placeholder wasn't being processed
- **Accurate Page Information**: Footer now displays correct total page count using custom implementation

## 2.5.23

### Bug Fixes
- **Fixed Footer Page Count**: Now uses TCPDF's {nb} placeholder for accurate total page count
- **Correct Page Display**: Footer now shows proper "Page X/Y" format with correct total pages
- **Professional PDF Layout**: Fixed issue where total pages showed same as current page
- **Accurate Page Information**: Footer now displays correct total page count

## 2.5.22

### Bug Fixes
- **Enhanced Footer with Total Pages**: Footer now displays "Page X/Y" format (e.g., "Page 1/7")
- **Professional PDF Layout**: Added total page count to footer for better document navigation
- **Improved User Experience**: Users can now see current page and total pages in footer
- **Better Document Management**: Enhanced footer provides complete page information

## 2.5.21

### Bug Fixes
- **Filtered Zero-Value Accounts**: Only accounts with non-zero amounts are now displayed in PDF detailed pages
- **Paper Saving**: Eliminated display of accounts with 0.00 amounts to save paper and improve readability
- **Improved Account Counts**: Resume now shows count of only non-zero accounts
- **Cleaner PDF Output**: Detailed pages now contain only relevant accounts with actual values

## 2.5.20

### Bug Fixes
- **Fixed Table Subtitle Positioning**: Added SetX positioning to match table alignment for subtitles
- **Improved Visual Consistency**: "Comptes de base (ventes)" and "Comptes de TVA" subtitles now properly positioned
- **Better Layout Alignment**: Subtitles use same X positioning as center-aligned table
- **Enhanced Visual Harmony**: Table and subtitles now have consistent positioning and alignment

## 2.5.19

### Bug Fixes
- **Fixed Table Subtitle Alignment**: Table subtitles now center-aligned to match table alignment
- **Improved Visual Consistency**: "Comptes de base (ventes)" and "Comptes de TVA" subtitles now properly centered
- **Better Layout Alignment**: Subtitles align with center-aligned table for professional appearance
- **Enhanced Visual Harmony**: Table and subtitles now have consistent center alignment

## 2.5.18

### Bug Fixes
- **Fixed Table Subtitle Width**: Table subtitles now use same width as table instead of stretching page-wide
- **Improved Table Layout**: "Comptes de base (ventes)" and "Comptes de TVA" subtitles now properly aligned
- **Better Visual Consistency**: Subtitles match table width for professional appearance
- **Enhanced Layout**: Table subtitles no longer extend beyond table boundaries

## 2.5.17

### Bug Fixes
- **Fixed Line 08 Amount Display**: Now shows separate base and VAT amounts for lines 08, 09, 9B
- **Improved Amount Summary**: Resume now displays "Montant de base: X | Montant de TVA: Y" for mixed amount lines
- **Better Amount Breakdown**: More accurate amount display in PDF detailed pages
- **Enhanced Clarity**: Clear distinction between base and VAT amounts in line summaries

## 2.5.16

### Bug Fixes
- **Fixed Line 08 Resume Display**: Now shows separate counts for base and VAT accounts for lines 08, 09, 9B
- **Improved Account Summary**: Resume now displays "Comptes de base: X | Comptes de TVA: Y" for mixed account lines
- **Better Line Details**: More accurate account breakdown in PDF detailed pages
- **Enhanced Clarity**: Clear distinction between base and VAT accounts in line summaries

## 2.5.15

### Bug Fixes
- **Fixed Company Information Source**: Now uses Dolibarr's $mysoc configuration instead of fetching separate company
- **Consistent Company Data**: PDF footer now uses the same company data as CA-3 form filling
- **Proper Data Source**: Uses $mysoc (Dolibarr company config) for all company information
- **Accurate Footer**: Company name in PDF footer now matches the company used in CA-3 form

## 2.5.14

### Bug Fixes
- **Fixed Company Information**: Now uses main company entity (1) instead of current entity
- **Correct Company Data**: PDF footer now shows the actual Dolibarr company, not first client
- **Proper Entity Selection**: Uses main company entity for consistent company information
- **Accurate Footer**: Company name in PDF footer now matches the actual Dolibarr company

## 2.5.13

### Bug Fixes
- **Fixed Class Definition Order**: Moved custom PDF class definition after TCPDF include
- **Proper Class Loading**: Custom class now extends TCPDF after it's loaded
- **Error Resolution**: Fixed "Class TCPDF not found" error by correct class definition order
- **Stable Implementation**: Custom PDF class now works with proper dependency loading

## 2.5.12

### Bug Fixes
- **Removed Duplicate TCPDF Include**: Removed incorrect TCPDF include since it's already loaded by Dolibarr
- **Fixed Path Error**: Resolved "Failed opening required" error for TCPDF file
- **Clean Implementation**: TCPDF is already available through Dolibarr's standard loading
- **Stable Footer**: Custom PDF class now works without duplicate includes

## 2.5.11

### Bug Fixes
- **Fixed TCPDF Loading**: Added proper TCPDF include statement before custom class definition
- **Class Loading**: Ensured TCPDF is loaded before extending it with custom PDF class
- **Error Resolution**: Fixed "Class TCPDF not found" error
- **Stable Implementation**: Custom PDF class now works correctly with proper dependencies

## 2.5.10

### Bug Fixes
- **Fixed Footer Implementation**: Corrected TCPDF footer implementation using custom PDF class
- **Proper Footer Method**: Used TCPDF's built-in Footer() method override instead of non-existent callback
- **Stable Footer**: Company name and page numbering now work correctly on all pages
- **Error Resolution**: Fixed "Call to undefined method TCPDF::setFooterCallback()" error

## 2.5.9

### UI/UX Improvements
- **Custom Footer**: Added company name on the left and page number on the right in footer
- **Font Consistency**: Footer uses the same font size as summary information (size 7)
- **Professional Branding**: Company name is displayed on every page
- **Complete Layout**: Enhanced footer with both company identification and page numbering

## 2.5.8

### UI/UX Improvements
- **Font Size Consistency**: Summary information now uses the same font size as tables (size 7)
- **Visual Harmony**: All text elements now have consistent typography
- **Professional Appearance**: Uniform font sizing throughout the PDF
- **Better Integration**: Summary text blends seamlessly with table content

## 2.5.7

### UI/UX Improvements
- **Fixed Layout**: Restored summary information while keeping titles removed
- **Balanced Design**: Summary details (period, account count, calculated amount) are preserved
- **Clean Titles**: Only the redundant "Résumé de la ligne" titles were removed
- **Complete Information**: All important summary data is still displayed

## 2.5.6

### UI/UX Improvements
- **Cleaner Layout**: Removed redundant "Résumé de la ligne" titles from detailed pages
- **Simplified Design**: Eliminated unnecessary summary sections to reduce clutter
- **Better Focus**: Users can now focus directly on the account details tables
- **Streamlined PDF**: Cleaner, more professional appearance without redundant information

## 2.5.5

### UI/UX Improvements
- **Thin Border Consistency**: Set all borders to thin (0.1) throughout the entire PDF
- **Professional Appearance**: All table cells, titles, and separators now use consistent thin borders
- **Visual Harmony**: Detailed page tables now have the same border thickness as first page tables
- **Clean Layout**: Consistent thin borders throughout the entire PDF document

## 2.5.4

### UI/UX Improvements
- **Column Width Consistency**: Updated detailed page tables to match first page column widths exactly
- **Perfect Table Proportions**: All tables now use identical column proportions (20, 60, 40)
- **Visual Harmony**: Detailed page tables now have the same width and proportions as journal tables
- **Professional Layout**: Consistent table sizing throughout the entire PDF

## 2.5.3

### UI/UX Improvements
- **Font Size Consistency**: Updated detailed page tables to match first page font sizes exactly
- **Perfect Table Matching**: All tables now use identical styling (font size 7, proper spacing)
- **Professional Appearance**: Detailed page tables now look identical to journal tables
- **Visual Harmony**: Consistent typography and spacing throughout the entire PDF

## 2.5.2

### UI/UX Improvements
- **Professional Table Styling**: Applied consistent table styling across all PDF pages
- **Enhanced Visual Consistency**: All tables now use the same professional styling as journal tables
- **Improved Readability**: White backgrounds for data rows, light gray for headers and subtotals
- **Unified Design**: Consistent appearance throughout the entire PDF document

## 2.5.1

### UI/UX Improvements
- **PDF Layout Enhancement**: Added light gray backgrounds to section titles in detailed pages
- **Visual Hierarchy**: Improved readability with distinct section headers
- **Professional Appearance**: Enhanced PDF presentation with consistent styling

## 2.5.0

### New Features
- **Journal Configuration Tab**: Complete journal account configuration system
- **Bank Account Configuration**: Configurable bank account for VAT payments/receipts
- **Auto-Create Accounting**: Toggle for automatic accounting entry creation on submission
- **Amount Calculation Method**: Configurable rounding vs truncation for French CA-3 compliance
- **Configurable Journal Accounts**: All journal accounts (VAT, charges, products) are now configurable
- **Database Auto-Creation**: Automatic table creation and default value setup

### Technical Improvements
- **Configuration Management**: Centralized configuration system with database storage
- **Account Loading**: Improved accounting account retrieval with proper ordering
- **Form Handling**: Fixed action processing outside tab logic for reliable form submission
- **Database Schema**: Auto-creation of missing tables with proper structure
- **Error Handling**: Comprehensive error handling and user feedback

### Bug Fixes
- **Configuration Persistence**: Fixed configuration saving issues
- **Account Display**: Resolved uppercase account label display in dropdowns
- **Form Actions**: Corrected action handling placement for reliable form processing
- **Database Tables**: Automatic creation of missing configuration tables

## 2.4.0

### New Features
- **Template Management System**: Complete online template management with Gitea integration
- **Minor Version System**: Major.minor versioning for template updates (30.1, 30.2, etc.)
- **Automatic Updates**: Other installations can automatically update templates
- **Template Reset**: "REVENIR AU MODELE OFFICIEL" functionality for template management
- **Configuration Tabs**: Separated PCG mapping and template management into distinct tabs

### Technical Improvements
- **Gitea Integration**: Online template distribution and version checking
- **Template Path Resolution**: Fixed template loading for PDF generation
- **Action Handling**: Improved template action processing outside tab logic
- **Version Management**: Comprehensive template versioning system
- **Fallback System**: Robust offline/online template management

### Bug Fixes
- **Template Recognition**: Fixed official template recognition for PDF generation
- **Path Resolution**: Corrected template path calculation for different directory structures
- **Action Processing**: Fixed template reset and update actions
- **PDF Generation**: Resolved missing CA-3 pages in PDF output
- **Template Loading**: Fixed template file detection and loading

### Template Updates
- **Version 30.2**: Updated official CA-3 template with corrected field positioning
- **Template Maintenance**: Added comprehensive maintenance manual
- **Version Control**: Implemented minor version system for template fixes

## 2.3.0

### New Features
- **Declaration Validation**: Complete validation workflow with confirmation dialogs
- **PDF Document Management**: Automatic PDF generation and storage for validated declarations
- **Document Download**: Secure PDF download system with proper authentication
- **Status Management**: Visual status indicators and proper workflow separation
- **Clean UI**: Streamlined interface with working actions only

### Technical Improvements
- **Database Migration**: Added validation tracking with proper database schema
- **Secure Downloads**: Token-based authentication for PDF downloads
- **Error Handling**: Comprehensive error handling without debug clutter
- **File Management**: Proper document storage in structured directories
- **UI Cleanup**: Removed non-working actions and streamlined interface

### Bug Fixes
- **Fixed Token Validation**: Resolved download handler authentication issues
- **Fixed PDF Detection**: Improved file pattern matching for document detection
- **Fixed Path Resolution**: Corrected file paths for document storage and access
- **Removed Debug Code**: Cleaned up production code from debugging statements
- **Fixed Button Actions**: Removed non-working buttons from declaration list

## 2.1.0

### New Features
- **Enhanced PDF Export**: CA-3 form now includes detailed breakdown pages in a single comprehensive PDF
- **Detailed Breakdown Pages**: Account-level details for each CA-3 line showing exactly where amounts come from
- **Improved PDF Merging**: Uses pdftk for reliable PDF merging that preserves form fields
- **Conditional Page Breaks**: Optimized page usage to reduce paper consumption
- **Enhanced Line Calculations**: Added support for lines 25, 26, 27, TD, 28, 32 with proper conditional visibility
- **Status Translation**: Proper French translation of declaration status in detailed PDFs

### Technical Improvements
- **Better Error Handling**: Comprehensive logging and debugging for PDF generation
- **Form Field Preservation**: pdftk-based merging maintains all form data integrity
- **Modular PDF Generation**: Separate detailed PDF generation with fallback options
- **Enhanced Debugging**: Detailed logging for troubleshooting PDF generation issues

### Bug Fixes
- **Fixed Multi-Select Saving**: Configuration fields now properly save when all selections are removed
- **Fixed PDF Merge Issues**: Resolved pdftk filename conflicts that prevented detailed pages from being added
- **Fixed Status Translation**: Eliminated "Call to a member function trans() on null" errors
- **Fixed Form Corruption**: Prevented FPDI merge from corrupting filled form data

## 1.1

### New Features
- **Enhanced PDF Export**: CA-3 form now includes detailed breakdown pages in a single comprehensive PDF
- **Detailed Breakdown Pages**: Account-level details for each CA-3 line showing exactly where amounts come from
- **Improved PDF Merging**: Uses pdftk for reliable PDF merging that preserves form fields
- **Conditional Page Breaks**: Optimized page usage to reduce paper consumption
- **Enhanced Line Calculations**: Added support for lines 25, 26, 27, TD, 28, 32 with proper conditional visibility
- **Status Translation**: Proper French translation of declaration status in detailed PDFs

### Technical Improvements
- **Better Error Handling**: Comprehensive logging and debugging for PDF generation
- **Form Field Preservation**: pdftk-based merging maintains all form data integrity
- **Modular PDF Generation**: Separate detailed PDF generation with fallback options
- **Enhanced Debugging**: Detailed logging for troubleshooting PDF generation issues

### Bug Fixes
- **Fixed Multi-Select Saving**: Configuration fields now properly save when all selections are removed
- **Fixed PDF Merge Issues**: Resolved pdftk filename conflicts that prevented detailed pages from being added
- **Fixed Status Translation**: Eliminated "Call to a member function trans() on null" errors
- **Fixed Form Corruption**: Prevented FPDI merge from corrupting filled form data

## 1.0

Initial version