initial commit
This commit is contained in:
@@ -0,0 +1,163 @@
|
||||

|
||||
<a href="https://www.producthunt.com/posts/indotalent-wms?embed=true&utm_source=badge-featured&utm_medium=badge&utm_souce=badge-indotalent-wms" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=836427&theme=light&t=1738304283591" alt="INDOTALENT WMS - Free and open-source powerful inventory management system | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
|
||||
# 🔥 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.
|
||||
|
||||
|
||||
|
||||
# Monolithic Clean Architecture
|
||||
|
||||
WHMS is built using a **Monolithic Clean Architecture** approach, ensuring a structured and simplified development process. By keeping all components within a single codebase, dependency management is streamlined, eliminating the risk of a **dependency nightmare**. This approach consolidates all dependencies in one place, ensuring compatibility and coherence across the entire system.
|
||||
|
||||
Additionally, it simplifies **deployment**, as all code resides in a single repository with a well-optimized pipeline, reducing complexity. The **cohesive project structure** provides a clear and consistent source code pattern, making it easier for developers to understand and maintain the system. With the combination of Clean Architecture, CQRS, and MediatR, WHMS delivers a **scalable, maintainable, and enterprise-ready solution**.
|
||||
|
||||
|
||||
|
||||
# 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 with a Simple & Modern UI** (Front End)
|
||||
- **Effortless** dynamic interactivity using Vue.js **without any build system**
|
||||
- **Ready-to-use** industry-leading Syncfusion UI components (free community edition)
|
||||
- **Lightweight and straightforward** API communication with Axios
|
||||
- **Easy-to-customize** responsive UI powered by the 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
|
||||
|
||||
Getting started is **easy**! Thanks to **Monolithic Clean Architecture**, everything is structured and streamlined. Plus, even though this project uses a **modern JavaScript framework like Vue.js**, it **does not require a build system**—just use Visual Studio to run and build effortlessly.
|
||||
|
||||
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
|
||||
|
||||
Deployment is **easy**! Thanks to **Monolithic Clean Architecture**, both the front end and back end are in a single deployable unit, making the process straightforward.
|
||||
|
||||
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**: admin@root.com
|
||||
- ✅ **Password**: 123456
|
||||
|
||||
|
||||
|
||||
|
||||
# Acknowledgments
|
||||
|
||||
This project uses the following open-source and community resources:
|
||||
|
||||
- [Syncfusion Community Edition](https://www.syncfusion.com/products/communitylicense) - For advanced UI components.
|
||||
- [AdminLTE](https://github.com/ColorlibHQ/AdminLTE) - Licensed under the MIT License.
|
||||
|
||||
We thank these projects for their contributions to the developer community.
|
||||
|
||||
|
||||
|
||||
# License
|
||||
|
||||
This work is licensed under a [Creative Commons Attribution 4.0 International License (CC BY 4.0)](http://creativecommons.org/licenses/by/4.0/).
|
||||
To view a copy of this license, visit [http://creativecommons.org/licenses/by/4.0/](http://creativecommons.org/licenses/by/4.0/).
|
||||
|
||||
Users are required to retain the footer link in all instances of this software as part of the attribution requirement under CC BY 4.0.
|
||||
|
||||
|
||||
|
||||
# Starred
|
||||
If you find this project useful, please consider supporting us by giving a star on GitHub! ⭐
|
||||
Your support keeps us motivated and 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. ❤️
|
||||
|
||||
|
||||
|
||||
# One Last Kiss ❤️
|
||||
|
||||
Thanks for stopping by and reading this far! This project is supported by **INDOTALENT**
|
||||
|
||||
🌐 Feel free to visit: [https://indotalent.com](https://indotalent.com)
|
||||
|
||||
[](https://indotalent.com)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user