Grant is a financial management system designed for individuals, families, and small businesses. The core design philosophy focuses on Data Consistency, Atomic Operations (ACID), and Extreme Traceability, ensuring every financial change is trackable and error-free.
The system provides rigorous Role-Based Access Control (RBAC), ensuring that different types of users (Administrators, Finance Officers, General Users) can only access data within their authorized scope.

Supports full transaction CRUD operations, recording every detail of change.

Administrators can easily manage organization members and permission assignments, maintaining the security of organizational operations.

- Atomic Bookkeeping: When adding records, the system guarantees that the main record and balance changes are written synchronously, preventing data discrepancies.
- Reversal Logic: When modifying or deleting transactions, the system does not erase data. Instead, it executes "reversal operations" to maintain balance equilibrium, preserving a complete Audit Trail.
- Linked Binding: When performing transfers, the system strictly binds outgoing and incoming records, ensuring the atomicity of both sides and preventing funds from disappearing or appearing out of thin air during movement.
- Atomic Import Mechanism: Supports high-volume Excel data imports. All data enters a "Staging Area" for validation and can only be committed to production tables with one click after confirmation.
- One-Click Batch Rollback: If imported data is found to be incorrect, an atomic rollback can be executed based on a Batch ID, quickly restoring the system to its pre-import state.
- High Concurrency Handling: Optimized for processing large volumes of financial records. The system remains responsive even when multiple users are performing complex report imports and queries simultaneously.
- Deployment Guide: Please refer to DEPLOY.md for production environment setup.
- Developer Guide: Please refer to DEVELOP.md for local development and contribution guidelines.
- Traditional Chinese Version: See README-zh-TW.md.
- Requirements & Design Decisions: Product Requirement Documents (PRD) and Architecture Decision Records (ADR) can be found in the
docs/directory.