Session History - 2025-12-23: Document Numbering Form Refactoring

Objective

Refactor and debug the "Test Number Generation" (Template Tester) form to support real API validation and master data integration.

Master Data Integration: Replaced manual text inputs with Select components for Originator, Recipient, Document Type, and Discipline.
Dynamic Data Hook:
- Integrated useOrganizations, useCorrespondenceTypes, and useDisciplines.
- Fixed empty Discipline list by adding useContracts to fetch active contracts for the project and deriving contractId dynamically.
API Integration: Switched from mock generateTestNumber to backend previewNumber endpoint.
UI Enhancements:
- Added "Default (All Types)" and "None" options to dropdowns.
- Improved error feedback with a visible error card if generation fails.
Type Safety:
- Resolved multiple lint errors (Unexpected any, missing properties).
- Updated SearchOrganizationDto in organization.dto.ts to include isActive.

DTO Updates:
- Refactored PreviewNumberDto to use originatorId and typeId (aligned with frontend naming).
- Added @Type(() => Number) and @IsInt() to ensure proper payload transformation.
Service Logic:
- Fixed CounterService mapping to correctly use the entity property originatorId instead of the DTO naming originatorOrganizationId in WHERE clauses and creation logic.
- Updated DocumentNumberingController to map the new DTO properties.

Issue: "Format Preview" was reported as missing.
Action: Attempted a property rename from formatTemplate to formatString across the frontend based on database column naming.
Result: This caused the entire Document Numbering page to fail (UI became empty) because the backend entity still uses the property name formatTemplate.
Resolution: Reverted all renaming changes back to formatTemplate. The initial "missing" issue was resolved by ensuring proper prop passing and data loading.

Test Generation Form: Fully functional and integrated with real master data.
Preview API: Validated and working with correct database mapping.
Next Steps: Monitor for any further data-specific generation errors (e.g., Template format parsing).

Reference Task: TASK-FE-017-document-numbering-refactor.md