Dar Al Ber Requests — Developer Docs

An internal request-and-approval system for جمعية دار البر (Dar Al Ber Society): employees submit service requests (vehicles, halls, stationery, visas, warehouse items…), a route of approvals and tasks runs with a deadline on each step, and the request completes with its last step. Rooms are booked, items are lent, stock moves, and reports read it all.

• Stack: .NET 10 · Blazor Server · MudBlazor 9 · EF Core 10 + PostgreSQL 17 · ASP.NET Core Identity · Serilog
• Shape: a modular monolith: a small core, a host, and modules in folders (modules/<name>/) discovered at startup
• The idea: a request type is data (a form, a route, deadlines), and every rule is a formula
• Language: UI in Arabic (RTL); code comments and these docs in English

The System map is the whole system on one clickable page. Then read Architecture, Rules and formulas, Permissions and Security. The API Reference is generated from the XML comments in the code.

flowchart LR
    E[Employee] -->|fills the published form| R[Request]
    R -->|formulas decide the route| S[Steps: approvals and tasks]
    S -->|each step has its deadline| S
    S -->|last step done| C[Completed]
    S -->|returned| E
    S -->|task done| F[Features: stock moves, rooms held, items lent]

Area	Read
How a request moves	Request lifecycle
How rules are written and judged	Rules and formulas
Shared lists, lent items and the stock ledger	Lists and inventory
Reports	Reports
Who may do what	Permissions
How it is protected	Security
What a server needs	Deployment
Adding a feature	Modules, Cookbook