Next-Generation Enterprise Accounting & ERP Foundation
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.
| 💰 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 |
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)
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.
The authentication layer uses a dedicated, high-focus layout.
| Login Page | Registration Page |
 |  |
📊 Dashboard / Home Page
👤 User Profile
| Profile View | Edit Profile |
 |  |
🗂️ IFRS Accounts (МСФО) — 9 Screen Workflow
Unified Main Table
| Details | Create | Edit | Delete |
 |  |  |  |
| Details | Create | Edit | Delete |
 |  |  |  |
📋 Reference Books (Справочники) — 9 Screen Workflow
Unified Main Table
| Details | Create | Edit | Delete |
 |  |  |  |
| Details | Create | Edit | Delete |
 |  |  |  |
💰 Cash Receipt Orders (ПКО)
| Details | Create | Edit | Delete |
 |  |  |  |
📈 Income Articles (Статьи доходов)
| Details | Create | Edit | Delete |
 |  |  |  |
⚖️ VAT Management (НДС)
| Details | Create | Edit | Delete |
 |  |  |  |
📊 Dashboard / Home Page
👤 User Profile
| Profile View | Edit Profile |
 |  |
🗂️ IFRS Accounts (МСФО) — 9 Screen Workflow
Unified Main Table
| Details | Create | Edit | Delete |
 |  |  |  |
| Details | Create | Edit | Delete |
 |  |  |  |
📋 Reference Books (Справочники) — 9 Screen Workflow
Unified Main Table
| Details | Create | Edit | Delete |
 |  |  |  |
| Details | Create | Edit | Delete |
 |  |  |  |
💰 Cash Receipt Orders (ПКО)
| Details | Create | Edit | Delete |
 |  |  |  |
📈 Income Articles (Статьи доходов)
| Details | Create | Edit | Delete |
 |  |  |  |
⚖️ VAT Management (НДС)
| Details | Create | Edit | Delete |
 |  |  |  |
Follow these steps to get a local copy up and running. Running the commands from the main server directory will automatically restore and build all linked projects (Client and Contracts).
-
Clone the repository:
git clone https://github.com/abdullokhonz/Bookkeeping.git cd Bookkeeping -
Navigate to the Main Server project:
The solution is structured to build all dependencies from this entry point:
cd Bookkeeping cd Bookkeeping -
Configure Environment (appsettings.json):
Update the configuration file inside the
Bookkeepingfolder with your credentials. You will need to set up the database, JWT, and service providers:{ "ApiSettings": { "BaseUrl": "https://localhost:7277/" }, "ConnectionStrings": { "DbPostgres": "Host=localhost;Port=5432;Database=BookkeepingDB;User ID=postgres;Password=your_password" }, "JwtSettings": { "Key": "YOUR_SECURE_JWT_KEY_HERE", "Issuer": "Bookkeeping_IdentityServer", "Audience": "Bookkeeping_WebClient", "LifetimeMinutes": 15 }, "EmailSettings": { "SmtpHost": "YOUR_SMTP_HOST_HERE", "SmtpPort": "YOUR_SMTP_PORT_HERE", "FromName": "Bookkeeping Notifications", "FromEmail": "YOUR_EMAIL_HERE", "EmailPassword": "YOUR_EMAIL_PASSWORD_HERE" }, "SmsSettings": { "Dlm": "YOUR_SMS_DLM_HERE", "T": "YOUR_SMS_T_HERE", "Login": "YOUR_SMS_LOGIN_HERE", "PassHash": "YOUR_SMS_PASSHASH_HERE", "Sender": "YOUR_SMS_SENDER_HERE" } } -
Build & Launch:
This will restore all projects (Server, Client, Contracts) and start the application:
dotnet restore dotnet build dotnet runThe platform will be available at your configured
BaseUrl.
| Environment | Access Instructions |
|---|---|
| 🌐 Web Frontend (Blazor) | Full authentication flow is active. You can register and log in to access the dashboard. |
| 🚀 Postman / External | Use /auth/login to obtain a token and add it to Authorization: Bearer header. |
| 🛠️ Swagger UI |
Warning: Authorize via Swagger UI is currently not configured. To test via Swagger: Manually remove the [Authorize] attribute from Controllers.
|
Contributions are welcome! If you have suggestions or want to contribute, please feel free to open issues or pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.