An open API service indexing awesome lists of open source software.

https://github.com/lufias786/mn-dastur

this is a full-featured business management solution
https://github.com/lufias786/mn-dastur

asp-net-core sql-server

Last synced: 8 months ago
JSON representation

this is a full-featured business management solution

Awesome Lists containing this project

README

          

# MN Dastur โ€” Company Management Dashboard

A modern, modular, and responsive company dashboard built with **ASP.NET Core MVC**, **C#**, and **SQL Server**.
This project serves as a unified system to manage company operations, employees, clients, and internal activities under one clean interface.

---

## ๐Ÿš€ Overview

**MN Dastur** is designed as a full-featured business management solution.
It includes everything a company dashboard needs โ€” from authentication and role-based access to detailed data views and modern UI design.

The project emphasizes:
- **Clean architecture**
- **Reusable modules**
- **Secure authentication**
- **Responsive layout**
- **Performance-first design**

---

## โœจ Features

- ๐Ÿ” **User Authentication & Authorization**
- Role-based access (Admin, Staff, etc.)
- Secure login & logout

- ๐Ÿงญ **Modular Dashboard**
- Centralized access to all company data and analytics
- Each module handles a specific business function

- ๐Ÿงพ **Dynamic Data Management**
- CRUD operations for company data
- Integrated validation and error handling

- ๐ŸŽจ **Modern & Responsive UI**
- Built using **Bootstrap 5**, **CSS**, and **JavaScript**
- Works seamlessly across all screen sizes

- โš™๏ธ **Configurable System**
- Easily update settings in `appsettings.json`
- Ready for development or production use

---

## ๐Ÿ› ๏ธ Tech Stack

| Layer | Technology Used |
|-------|-----------------|
| **Frontend** | HTML5, CSS3, JavaScript, Bootstrap |
| **Backend** | ASP.NET Core MVC (C#) |
| **Database** | SQL Server |
| **Authentication** | ASP.NET Identity |
| **Environment Config** | `appsettings.json` |
| **IDE** | Visual Studio / VS Code |

---

## ๐Ÿ“‚ Project Structure

```

mn-dastur/
โ”‚
โ”œโ”€โ”€ Controllers/ # MVC Controllers for various modules
โ”œโ”€โ”€ Models/ # Data and domain models
โ”œโ”€โ”€ Views/ # Razor views (UI templates)
โ”œโ”€โ”€ wwwroot/ # Static files (CSS, JS, images)
โ”œโ”€โ”€ appsettings.json # Configuration settings
โ”œโ”€โ”€ Program.cs # Entry point
โ”œโ”€โ”€ MN.Dastur.csproj # Project definition
โ””โ”€โ”€ README.md # Project documentation

````

---

## โšก Getting Started

### Prerequisites
Make sure you have:
- [.NET SDK 8.0+](https://dotnet.microsoft.com/)
- [SQL Server](https://www.microsoft.com/en-us/sql-server)
- Visual Studio / VS Code installed

---

### Installation

1. **Clone this repository**
```bash
git clone https://github.com/Lufias786/mn-dastur.git
cd mn-dastur
````

2. **Restore dependencies**

```bash
dotnet restore
```

3. **Update configuration**

* Open `appsettings.json`
* Add your SQL connection string and other environment details

4. **Run the project**

```bash
dotnet run
```

Visit: [https://localhost:5001](https://localhost:5001)

---

## ๐Ÿงญ Usage

* **Login** using your credentials (admin or staff)
* **Navigate** through the dashboard modules
* Manage company data: employees, departments, or clients
* **Add/Edit/Delete** records easily through the web interface

> The project is designed to be modular โ€” you can add new sections (modules) without breaking existing functionality.

---

## ๐Ÿ“ก API Overview (if applicable)

| Method | Endpoint | Description |
| ------ | --------------------- | ----------------------- |
| GET | `/api/employees` | Fetch all employees |
| POST | `/api/employees` | Add new employee |
| PUT | `/api/employees/{id}` | Update employee details |
| DELETE | `/api/employees/{id}` | Remove employee |

---

## ๐Ÿค Contributing

Contributions are always welcome!
If youโ€™d like to improve the UI, optimize performance, or fix bugs:

1. Fork this repository
2. Create your feature branch

```bash
git checkout -b feature/your-feature
```
3. Commit changes

```bash
git commit -m "Added new dashboard feature"
```
4. Push and open a Pull Request

---

## ๐Ÿงพ License

This project is licensed under the **MIT License**.
You are free to use, modify, and distribute it for both personal and commercial purposes.

---

## ๐Ÿ’ฌ Contact

**Author:** Saiful Hossain
**GitHub:** [Lufias786](https://github.com/Lufias786)
**Email:** (saifulhossain439@gmail.com)

---

> โ€œMN Dastur is built with scalability, design quality, and practicality in mind โ€”
> a complete company management dashboard made the right way.โ€

```