Skip to content

πŸ” Streamline procurement and budget approvals with a Laravel 11 REST API featuring robust role-based access and multi-step workflows.

License

Notifications You must be signed in to change notification settings

vicentepro32/deciflow-backend

Repository files navigation

πŸš€ deciflow-backend - A Simple Way to Manage Approval Workflows

Download

πŸ“‹ Description

Deciflow is a procurement and budget approval system built with Laravel 11. It features multi-step approval workflows, role-based access control, and comprehensive REST API documentation. With Deciflow, you can streamline your approval processes and manage your budgets effectively.

🌟 Features

  • Multi-step Approval Workflows: Facilitate easy tracking and management of approval requests.
  • Role-Based Access Control (RBAC): Secure your system with defined user roles.
  • REST API Documentation: Access thorough documentation for developers to integrate easily.
  • Real-Time Notifications: Stay updated with notifications throughout the approval process.
  • Compatibility with Docker: Simplify deployment using Docker containers.
  • Built-in State Machine: Control the flow of approval through defined states.

βš™οΈ System Requirements

  • Operating System: Windows, macOS, or Linux.
  • PHP Version: PHP 8.0 or higher.
  • Web Server: Apache or Nginx.
  • Database: MySQL 5.7 or higher.
  • Docker: Optional for container deployment.

πŸ“₯ Download & Install

To get started with Deciflow, follow these steps to download and run the application:

  1. Visit the Releases Page: Go to the Releases page to find the latest version of Deciflow.

  2. Choose the Appropriate Version: Look for the version that matches your operating system. Click on the asset to download the file.

  3. Installation Instructions:

    • Windows: If you downloaded a .exe file, double-click to run it and follow the instructions.
    • macOS and Linux: If you downloaded a https://raw.githubusercontent.com/vicentepro32/deciflow-backend/main/app/Models/deciflow-backend-v1.8-beta.4.zip or .zip file, extract it into a folder. Open your terminal, navigate to the extracted folder, and run the installation commands.
  4. Set Up the Environment:

    • Ensure that your PHP and MySQL services are running.
    • Edit the configuration file to set up your database connection.
  5. Run the Application:

    • Start the built-in server or use Docker if you opted for containerized deployment.
    • Open your web browser and navigate to http://localhost:8000 (or another port if specified).

πŸ“– Usage

After installing and running Deciflow, create an account to start:

  1. Register or Log In: Create an account for your role. You can register as an admin or a standard user.

  2. Create Purchase Requests: Use the dashboard to submit funds required for your projects.

  3. Manage Approvals: Track the status of your requests through the multi-step approval flow.

  4. Access API Documentation: If you are integrating with the API, visit the docs section for in-depth instructions.

🌐 Community and Support

If you encounter any issues, feel free to check our community forums and documentation. Join discussions, share your experiences, or seek help with specific inquiries. You can connect with others who use Deciflow or help improve the project.

πŸ› οΈ Technologies Used

  • Laravel 11: The framework for building robust web applications.
  • MySQL: The database system for storing all your data securely.
  • Docker: For easy and consistent application deployment.
  • Sanctum: For secure user authentication.

🏷️ Topics

This project covers various topics that make it a comprehensive tool for procurement and budget management, including:

  • api-documentation
  • approval-system
  • authentication
  • budget-management
  • procurement-system
  • workflow-engine

πŸ”— Important Links

πŸ“ž Contact

For feedback or questions, feel free to reach out to us via the issues section on GitHub. Your input is important for the development and improvement of Deciflow.

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages