Skip to content

README.md

Latest commit

 

History

History
84 lines (62 loc) · 4.02 KB

README.md

File metadata and controls

84 lines (62 loc) · 4.02 KB
Raw

🌌 Bookkeeping Platform

Next-Generation Enterprise Accounting & ERP Foundation

License Build Status Contributors

.NET 10 Blazor PostgreSQL CQRS Clean Architecture

Bookkeeping is a production-ready, scalable financial management system built on Clean Architecture and CQRS. Designed as a robust foundation for a full ERP ecosystem, it moves beyond simple CRUD to handle complex business logic, IFRS compliance, and real-time financial tracking.

✨ Enterprise-Grade Features

💰 Financial Engine 🌍 IFRS Compliance 📊 Real-Time Analytics
• Document lifecycle (Draft ➔ Processed)
• Automated sequence numbering
• Dynamic VAT calculation		 • Tree-based account structures
• Hierarchical financial modeling
• Multi-region tax ready		 • Live dashboard updates
• Interactive MudBlazor charts
• Instant financial insights
📚 Master Data 🔐 Advanced Security 📂 Asset Handling
• Centralized reference data
• Flexible categorization
• Smart alphabetical sorting		 • JWT Auth & Refresh Tokens
• Protected API endpoints
• Role-based access control		 • Secure file uploads
• Document attachment system
• Image & media management

🏗️ Architecture & CQRS

The platform enforces a strict Clean Architecture, ensuring the core domain remains isolated from infrastructure and presentation concerns. State mutations and data retrieval are strictly separated using the CQRS pattern via MediatR.

  • 🟢 Commands: Mutate state containing complex business validations.
  • 🔵 Queries: Highly optimized read operations returning clean DTOs.
  • 🧩 Handlers: Isolated business logic ensuring high testability and maintainability.
📂 View Project Structure 👇 
📦 Bookkeeping Solution  
├── 📂 Bookkeeping  
│   ├── 📂 Bookkeeping (Main Server / API)  
│   │   ├── 📂 Application (Commands / Queries / Handlers)  
│   │   ├── 📂 Entities (Domain Models)  
│   │   ├── 📂 Controllers (API Endpoints)  
│   │   ├── 📂 Infrastructure (EF Core, Auth, Repositories)  
│   │   ├── 📂 Services (Business logic implementations)  
│   │   └── 📂 Components (Blazor Server UI)  
│   │  
│   └── 📂 Bookkeeping.Client (Blazor WASM Frontend)  
│       ├── 📂 Pages (Accounts, Auth, Orders, etc.)  
│       ├── 📂 Providers (Auth State)  
│       └── 📂 Layouts & Dialogs  
│  
└── 📂 Bookkeeping.Contracts (Shared Library)  
    ├── 📂 DTOs & Models  
    ├── 📂 Enums  
    └── 📂 Common (Responses, Results, Pagination)

🤝 Contributing

Contributions are welcome! If you have suggestions or want to contribute, please feel free to open issues or pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.