Dabir v0.5.0 - Letter Attachments and S3 Storage

Dabir v0.5.0

Highlights

• Added optional letter scan / attachment upload
• Added S3-compatible object storage support
• Added MinIO support for local/on-prem deployments
• Added attachment metadata persistence
• Added upload, list, view/download URL, and delete APIs
• Added optional attachment upload during letter creation
• Added attachment preview in letter details
• Added attachment management in edit letter page
• Added Helm S3 configuration
• Updated README with attachment and object storage documentation

Storage

Dabir now stores uploaded letter scans in S3-compatible object storage and keeps only metadata in PostgreSQL.

Supported object storage examples:

• MinIO
• Exoscale Object Storage
• Any S3-compatible storage

Notes

Attachments are optional. Users can create letters without uploading files.

Dabir v0.4.2 - Smart Manual Number Suggestions

Dabir v0.4.2

Improvements

• Added smart manual letter number suggestions
• Suggested next number now works based on the entered number prefix
• Supports patterns like 405-, 405-ق-, HR-2026-, and similar custom formats
• Added "last similar number" display in the new letter form
• Added "use suggested number" action in the new letter form
• Improved support for Persian and Arabic digits in manual number suggestions
• Normalized Persian/Arabic digits before backend suggestion lookup
• Improved suggestion behavior for mixed Persian/Latin letter numbers

Fixes

• Fixed old imported numbers with reversed Persian/Latin order such as 001-ق-405
• Updated display letter number unique index to ignore soft-deleted letters
• Improved backend suggestion lookup to handle normalized legacy numbers
• Fixed suggestion prefix extraction when users type a complete manual number

Notes

This is a patch release focused on improving manual numbering UX after the Excel import and manual numbering features introduced in v0.4.0.

Dabir v0.4.1 - Letter Sorting and Number Display Fixes

Dabir v0.4.1

Fixes and Improvements

• Fixed mixed Persian/Latin letter number display
• Fixed reversed imported contract numbers such as 101-ق-405
• Improved default letter list sorting by letter date
• Added reliable tie-break sorting for letters with the same date
• Fixed latest letter number display in Dashboard
• Fixed latest letter number display in New Letter page
• Added suggested next manual letter number
• Improved manual number placeholder behavior
• Improved search and sort behavior in the letters list

Dabir v0.4.0 - Manual Numbering and Excel Import Improvements

Dabir v0.4.0

This release adds manual letter numbering and improves real-world Excel import support.

Highlights

• Added manual numbering mode
• Added support for custom letter numbers with any structure
• Added display_letter_number for preserving original letter numbers
• Updated letter formatting to show manual numbers exactly as entered
• Added duplicate validation for manual/display letter numbers
• Updated new letter form to support manual numbering
• Updated setup UI to include manual numbering mode
• Updated settings UI to display manual numbering configuration
• Improved Excel import flow for legacy letter data
• Excel import now preserves original letter numbers
• Excel import no longer forces letter numbers into numeric format
• Improved import preview page
• Fixed import route showing the letters list page
• Improved Excel parser to detect importable sheets by columns instead of fixed sheet names
• Improved Persian/Jalali date parsing for import files
• Added better support for importing real-world organization Excel files

Numbering Modes

Dabir now supports three numbering modes:

• Fixed prefix: DABIR-000001
• Jalali yearly: 405-0001
• Manual: 405-158, 1401-MM-DM-95, 99-330-216, or any custom format

Manual Numbering

In manual numbering mode:

• Users enter the letter number manually
• Dabir stores and displays the number exactly as entered
• Dabir checks duplicate letter numbers
• Imported legacy numbers are preserved

Excel Import

Excel import is now better suited for real-world migration scenarios where historical letter numbers may have different formats.

Notes

This is still a pre-1.0 release and may include breaking changes before the first stable version.

Dabir v0.3.0 - Jalali Yearly Numbering and UI Improvements

Dabir v0.3.0

This release improves Dabir's real-world usability for Iranian letter registry workflows.

Highlights

• Added Jalali yearly letter numbering mode
• Added numbering mode selection during setup
• Added support for formats like 405-0001
• Added yearly letter counters
• Improved letter description persistence and API response
• Added letter preview modal in the UI
• Added letter delete action in the UI
• Added pagination to the letters list
• Improved responsive behavior of the letters table
• Fixed horizontal overflow issues in the web UI
• Improved settings UI to show numbering configuration
• Imported real-world incoming Excel data into the current schema
• Improved legacy data handling using the current database structure

Numbering

Dabir now supports two numbering modes:

• Fixed prefix: DABIR-000001
• Jalali yearly: 405-0001

In Jalali yearly mode, numbering resets per Jalali year.

Example:

• 1405 → 405-0001
• 1406 → 406-0001

UI Improvements

• Letters list now supports pagination
• Long Persian text no longer breaks the layout
• Letter details can be viewed from the list
• Editors and superusers can delete letters from the UI

Notes

This is still a pre-1.0 release and may include breaking changes before the first stable version.

Dabir v0.2.0 - Full-stack Release

Dabir v0.2.0

This release turns Dabir from a backend-focused MVP into a full-stack letter numbering and registry system.

Highlights

• Added Next.js web admin panel
• Added first-time setup UI
• Added login and protected routes
• Added role-aware sidebar
• Added letters list and create letter UI
• Added letter creation confirmation dialog
• Added Excel import UI
• Added users management UI
• Added password change and reset password UI
• Added audit logs UI
• Added settings UI
• Added dark mode support
• Added Persian / English localization foundation
• Added RTL-friendly interface improvements
• Added Jalali / Persian date support
• Added Jalali date picker
• Added Persian digit support in Jalali dates
• Added Docker Compose deployment
• Added Kubernetes Helm chart
• Added external PostgreSQL support for Kubernetes deployments
• Refreshed README and documentation structure

Backend Updates

• Added sender and receiver fields to letters
• Added Excel import preview and commit flow
• Added duplicate detection during import preview
• Added password change endpoint
• Added reset user password endpoint
• Added Jalali date parsing and formatting
• Added Persian digit normalization for date inputs
• Improved audit logging actions

Frontend Updates

• Added full web UI under web/
• Added authentication flow
• Added setup wizard
• Added letter management pages
• Added import workflow UI
• Added users and audit logs pages
• Added settings page
• Added password management pages
• Added Jalali date picker
• Improved RTL table alignment
• Improved dashboard statistics display

Deployment

• Docker Compose support for:

  • PostgreSQL
  • API
  • Web UI

• Helm chart support for:

  • API Deployment
  • Web Deployment
  • Services
  • Ingress
  • ConfigMap
  • Secret
  • HPA
  • PDB
  • External PostgreSQL

Notes

PostgreSQL is not deployed by the Helm chart. The chart expects an external PostgreSQL database.

This release is still pre-1.0 and may include breaking changes in future versions.