Create README.md

Create README.md

Author: go2ismail

README.md

@@ -0,0 +1,142 @@
+# 🔥 Introduction  
+Welcome to our **Warehouse Inventory Management System (WHMS)**, an innovative and scalable solution meticulously crafted to streamline and optimize your inventory operations.  
+
+Now powered by **ASP.NET Core 9.0**, the latest cutting-edge technology from Microsoft, WHMS is faster than ever and showcases the future of modern web development. With its fully decoupled **headless API** architecture, WHMS enables seamless integration between the back end and front end, offering unparalleled flexibility and performance.  
+
+The back end is built using **Clean Architecture**, **CQRS**, **MediatR**, and the **Repository Pattern**, ensuring maintainability and scalability for enterprise-grade applications. On the front end, **ASP.NET Core Razor Pages** and **Vue.js** come together to create a dynamic and user-friendly interface.  
+
+### Key Features  
+WHMS provides a comprehensive suite of capabilities:  
+- **Sales, Purchase, Delivery, and Goods Receive**  
+- **Transfer, Adjustment, Return, and Scrapping**  
+- **Stock Count and Detailed Reporting Functionalities**  
+
+🎯 **Challenge Yourself!**  
+Experience the blazing speed and efficiency of **.NET 9**, the latest breakthrough in performance from Microsoft. Explore our **live online demo** today and see firsthand how WHMS can revolutionize your inventory management operations.  
+
+
+---
+
+# Technical Features
+- **ASP.NET Core 9.0 Headless API** (Back End)
+  - Clean Architecture
+  - CQRS with MediatR
+  - Repository Pattern
+  - Entity Framework Core (EF Core) for data access
+  - AutoMapper for object mapping
+  - FluentValidation for input validation
+  - Serilog for logging
+  - Support for file uploads and downloads (images/documents)
+  - Secure authentication and authorization with ASP.NET Identity + JWT
+- **ASP.NET Core Razor Pages + Vue.js** (Front End)
+  - Dynamic client-side interactivity with Vue.js
+  - Modular, component-based architecture
+  - Axios for API communication
+  - Responsive UI with AdminLTE template
+
+---
+
+# Functional Features
+- **Customer Management**
+  - Customer Group, Category, Details, and Contacts
+- **Sales Management**
+  - Sales Order, Sales Return, Sales Reports
+- **Vendor Management**
+  - Vendor Group, Category, Details, and Contacts
+- **Purchase Management**
+  - Purchase Order, Purchase Return, Purchase Reports
+- **Warehouse Operations**
+  - Unit Measure, Product Group, Products
+  - Delivery Order, Goods Receive
+  - Transfers, Adjustments, Scrapping, Stock Counts
+- **Reporting**
+  - Transaction Report, Stock Report, Movement Report
+- **System Settings**
+  - Company Settings, Tax Configuration, User Management
+  - Number Sequence for systematic tracking
+- **Analytics and Logs**
+  - Error Logs, Analytic Logs
+- **Authentication & Membership**
+  - Secure user authentication and role-based access control
+
+---
+
+# Run The Project: Visual Studio
+Follow these simple steps to get started:
+1. Open the project using Visual Studio.
+2. Update the connection string in `appsettings.json` to match your SQL Server database.
+3. Clean and build the solution:
+   - Right-click the solution > Clean
+   - Right-click the solution > Build
+4. Run the project:
+   - Click the green "play" button in the Visual Studio toolbar.
+
+> **Note**: The database will be created automatically if it does not exist.
+
+---
+
+# Run The Project: IIS Web Server
+For deployment to IIS:
+1. Publish the project:
+   - Right-click the project > Publish.
+   - Choose a folder to output the files.
+2. Deploy to IIS:
+   - Copy the published files to your IIS directory.
+   - Configure IIS to point to the folder and ensure database connectivity.
+
+> For detailed instructions, refer to [Microsoft's official IIS deployment documentation](https://learn.microsoft.com/en-us/aspnet/core/tutorials/publish-to-iis).
+
+---
+
+# Live Demo Link
+- **URL**: [https://whms-lte-fs.csharpasp.net/](https://whms-lte-fs.csharpasp.net/)
+- **Username**: [email protected]  
+- **Password**: 123456
+
+---
+
+# Credits
+- **Syncfusion Community License**: [https://www.syncfusion.com/products/communitylicense](https://www.syncfusion.com/products/communitylicense)  
+- **AdminLTE HTML Admin Template**: [https://adminlte.io/](https://adminlte.io/)
+
+---
+
+# Starred  
+Love this project? Show your support by giving us a star on GitHub! ⭐  
+Your support helps us continue developing and improving this project to deliver even greater value to the community.  
+
+
+---
+# 🌱 Help Us Grow!  
+Please help us grow by sharing it with your friends, family, and colleagues!  
+
+Every share helps us reach more people, grow the community, and continue improving this open-source project. ⭐  
+Together, we can build something even greater—thank you for being a part of this journey!  
+
+---
+
+# Supporters  
+This project is proudly supported by **INDOTALENT**, your trusted partner for professional software solutions.  
+
+🎉 **Exclusive Offer:** Get an incredible **50% discount** on their products using the code **GITHUB50**. Don’t miss this opportunity to enhance your projects with top-notch solutions!  
+
+🌐 Visit now: [https://store.indotalent.com](https://store.indotalent.com)  
+
+
+---
+
+# Need a Production-Ready Codebase?  
+Unlock the power of a fully functional **ASP.NET Core Full Stack Application** with an enterprise-grade **Headless API**.  
+
+💡 **Why Choose This?**  
+This solution features a **decoupled business process architecture**, ensuring total separation between the back-end API and the front-end UI. Built with **Clean Architecture, CQRS, and MediatR**, it provides unparalleled flexibility and scalability for modern development needs.  
+
+And the price? It's **lower than your employee's T-shirts**, offering incredible value for your investment!  
+
+![Enterprise Full Stack Application](https://store.indotalent.com/cdn/shop/files/aspnet-wms-fs-hero6_1f3bb4d4-6a12-47ae-b31b-1e60e655e3b2_1024x1024@2x.png?v=1736228154)  
+
+📥 [Get the Source Code and Book Now](https://store.indotalent.com/collections/featured-product/products/inventory-wms-full-stack-edition)  
+
+Don’t miss this opportunity to supercharge your development with a cutting-edge, production-ready solution! 🚀  
+
+