feat: add BulkCreateSavingsDto and BulkSavingsItemDto for batch savin…

[Oluwasuyi-Timilehin]

Description

This PR addresses backend issue #1141 by introducing a transactional bulk operations endpoint (/savings/bulk-create) within the Savings module. The system handles multiple incoming operational payloads atomically while enforcing strict per-item validations and ensuring execution idempotency via unique batch markers.

Fixes #1141

Type of Change

• New feature (non-breaking change which adds functionality)
• Bug fix (non-breaking change which fixes an issue)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

Proposed Architecture & Changes

1. Data Validation (bulk-create-savings.dto.ts): Implemented explicit class-validator constraints to check each individual item within the input list array before processing hits the query runner.
2. Idempotency Guard (savings.service.ts): Integrated an execution tracking lookup check. Duplicate incoming identical batchId submissions are detected immediately, aborting re-execution and returning a cached state indicator safely.
3. Transactional Safety / All-or-Nothing Strategy: Utilized TypeORM explicit database QueryRunner transactions. If a single ledger assignment item throws an exception inside the processing collection loop, the entire database transaction automatically rolls back.

---

How to Manually Test This Feature

Prerequisites

Ensure your local backend server runtime is active:

npm run start:dev

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
nestera	Error		Jun 30, 2026 3:28am