Skip to content

abdullokhonz/Bookkeeping

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

26 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒŒ 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) 

๐Ÿ“ธ Application Gallery

Explore the complete visual ecosystem of the Bookkeeping application. The gallery showcases our sophisticated UI, covering complex CRUD workflows for both data records and their respective categories across Light and Dark themes.

๐Ÿ” 1. Authentication & Onboarding (Fixed Theme)


The authentication layer uses a dedicated, high-focus layout.

Login PageRegistration Page
LoginRegister

โ˜€๏ธ 2. Light Theme Experience


๐Ÿ“Š Dashboard / Home Page

Dashboard Light

๐Ÿ‘ค User Profile
Profile ViewEdit Profile
Profile ViewEdit Profile
๐Ÿ—‚๏ธ IFRS Accounts (ะœะกะคะž) โ€” 9 Screen Workflow

Unified Main Table

IFRS Main

๐Ÿ”น Account Management

DetailsCreateEditDelete

๐Ÿ”น Category Management

DetailsCreateEditDelete
๐Ÿ“‹ Reference Books (ะกะฟั€ะฐะฒะพั‡ะฝะธะบะธ) โ€” 9 Screen Workflow

Unified Main Table

Reference Main

๐Ÿ”น Reference Item Management

DetailsCreateEditDelete

๐Ÿ”น Category Management

DetailsCreateEditDelete
๐Ÿ’ฐ Cash Receipt Orders (ะŸะšะž)
Orders List
DetailsCreateEditDelete
๐Ÿ“ˆ Income Articles (ะกั‚ะฐั‚ัŒะธ ะดะพั…ะพะดะพะฒ)
Income List
DetailsCreateEditDelete
โš–๏ธ VAT Management (ะะ”ะก)
VAT List
DetailsCreateEditDelete

๐ŸŒ™ 3. Dark Theme Experience


๐Ÿ“Š Dashboard / Home Page

Dashboard Dark

๐Ÿ‘ค User Profile
Profile ViewEdit Profile
๐Ÿ—‚๏ธ IFRS Accounts (ะœะกะคะž) โ€” 9 Screen Workflow

Unified Main Table

IFRS Main Dark

๐Ÿ”น Account Management

DetailsCreateEditDelete

๐Ÿ”น Category Management

DetailsCreateEditDelete
๐Ÿ“‹ Reference Books (ะกะฟั€ะฐะฒะพั‡ะฝะธะบะธ) โ€” 9 Screen Workflow

Unified Main Table

Reference Main Dark

๐Ÿ”น Reference Item Management

DetailsCreateEditDelete

๐Ÿ”น Category Management

DetailsCreateEditDelete
๐Ÿ’ฐ Cash Receipt Orders (ะŸะšะž)
Orders List Dark
DetailsCreateEditDelete
๐Ÿ“ˆ Income Articles (ะกั‚ะฐั‚ัŒะธ ะดะพั…ะพะดะพะฒ)
Income List Dark
DetailsCreateEditDelete
โš–๏ธ VAT Management (ะะ”ะก)
VAT List Dark
DetailsCreateEditDelete

๐Ÿค 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.


Releases

No releases published

Packages

 
 
 

Contributors