StockTrackingApp

Overview

The application leverages several powerful libraries to offer robust functionality:

• 🌟.NET MAUI for cross-platform, native Windows development.
• 🌟UnitsNET for precise unit conversion and calculations (e.g., converting kilograms to grams).
• 🌟CommunityToolkit for enhanced UI components and additional features.
• 🌟SQLite for local, lightweight database management.

Features

Unit Conversion

Thanks to UnitsNET, the system can handle calculations between different units (like kilograms, grams, etc.), ensuring precise measurements throughout the application.

Product Management

• 🌟Menu Products: Represents final products (e.g., dishes) that have associated materials.
• 🌟Inventory Products: Represents raw materials or sub-products stored in the inventory.

Order Processing

The application automatically deducts the necessary quantities from inventory when processing orders.

Example: For a kebab requiring 300g of meat and 100g of yogurt:

• 🌟A single kebab order deducts 300g of meat and 100g of yogurt.
• 🌟A double order deducts 600g of meat and 200g of yogurt.

Transaction Logging

Detailed records are maintained for each transaction. Logs include information about:

• 🌟Who placed the order.
• 🌟Which product was ordered.
• 🌟The quantity and time of the order.

Separate records are kept for menu and inventory transactions.

User Authentication & Role Management

The system supports a secure user verification system with two roles:

• 🌟Admin: Full access and management privileges.
• 🌟Member: Limited access based on defined permissions.

Data Import/Export

Tables can be imported from external sources in Excel or SQL file formats, making it easy to integrate existing data.

Statistics Dashboard

A dedicated statistics page provides insights into various metrics, allowing users to monitor sales, inventory levels, and other key performance indicators.

Batch Processing

The multi-product transaction page allows simultaneous entry and exit operations for multiple products, streamlining bulk data handling.

Dynamic UI

Colors change depending on Windows theme.

Technologies Used

• 🌟.NET MAUI: For building the native Windows application.
• 🌟UnitsNET: For unit conversions (e.g., between kilograms and grams).
• 🌟CommunityToolkit: For additional UI components and features.
• 🌟SQLite: For managing a local database efficiently.

Installation

1. Prerequisites:
   • 🌟.NET MAUI
   • 🌟Windows 10, 11 operating system
   • 🌟Visual Studio with the .NET MAUI workload installed
2. Clone the Repository:

   git clone https://github.com/yourusername/your-repo-name.git

3. Build the Project:
   - Open the solution file in Visual Studio.
   - Build the project to restore all dependencies and compile the code.
4. Run the Application:
   - Set the Windows project as the startup project.
   - Run the application through Visual Studio.

Usage

• 🌟 Navigating the Application: The intuitive interface allows for easy navigation between managing menu products and inventory.
• 🌟 Processing Orders: When an order is placed, the application automatically calculates and deducts the required quantities of each ingredient from the inventory.
• 🌟 User Management: Admins can manage user accounts and assign roles (Admin/Member) to ensure secure access to the system.
• 🌟 Data Import: Use the import feature to load product and inventory data from Excel or SQL files.
• 🌟 Viewing Statistics: Check the statistics page for insights into sales trends and inventory status.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request with your proposed changes. For any issues or suggestions, feel free to open an issue in the repository.

License

This project is licensed under the MIT License.