README

English | 中文

A comprehensive Symfony bundle for purchase management that provides order management, approval workflow, and delivery tracking capabilities.

Features

Purchase Order Management: Create, update, and track purchase orders with unique order numbers
Supplier Integration: Seamless integration with supplier management
Approval Workflow: Built-in approval process for purchase orders
Delivery Tracking: Track purchase deliveries and receipt confirmations
EasyAdmin Integration: Ready-to-use admin interface with EasyAdmin
Audit Trail: Complete audit trail with user tracking and IP logging
Workflow Support: Symfony Workflow integration for complex approval processes

Installation

composer require tourze/purchase-manage-bundle

Configuration

return [
    // ...
    Tourze\PurchaseManageBundle\PurchaseManageBundle::class => ['all' => true],
];

Dependencies

This bundle requires the following bundles:

DoctrineBundle
ProductCoreBundle
SupplierManageBundle
EasyAdminMenuBundle

Usage

Basic Purchase Order Creation

<?php

use Tourze\PurchaseManageBundle\Entity\PurchaseOrder;
use Tourze\PurchaseManageBundle\Enum\PurchaseOrderStatus;

// Create a new purchase order
$purchaseOrder = new PurchaseOrder();
$purchaseOrder->setTitle('Office Supplies Purchase');
$purchaseOrder->setSupplier($supplier);
$purchaseOrder->setStatus(PurchaseOrderStatus::DRAFT);

// Add items to the order
$purchaseOrderItem = new PurchaseOrderItem();
$purchaseOrderItem->setProduct($product);
$purchaseOrderItem->setQuantity(10);
$purchaseOrderItem->setUnitPrice(25.50);

$purchaseOrder->addItem($purchaseOrderItem);

// Save the order
$entityManager->persist($purchaseOrder);
$entityManager->flush();

Approval Workflow

<?php

use Tourze\PurchaseManageBundle\Entity\PurchaseApproval;

// Create approval record
$approval = new PurchaseApproval();
$approval->setPurchaseOrder($purchaseOrder);
$approval->setApprover($user);
$approval->setStatus('approved');
$approval->setComment('Approved for office supplies');

$entityManager->persist($approval);
$entityManager->flush();

// Update purchase order status
$purchaseOrder->setStatus(PurchaseOrderStatus::APPROVED);
$entityManager->flush();

Delivery Tracking

<?php

use Tourze\PurchaseManageBundle\Entity\PurchaseDelivery;

// Record delivery
$delivery = new PurchaseDelivery();
$delivery->setPurchaseOrder($purchaseOrder);
$delivery->setDeliveryDate(new \DateTime());
$delivery->setTrackingNumber('TRACK123456');
$delivery->setStatus('delivered');

$entityManager->persist($delivery);
$entityManager->flush();

Configuration Options

You can configure the bundle using YAML or XML configuration:

# config/packages/purchase_manage.yaml
purchase_manage:
    # Default approval workflow
    approval_required: true
    auto_approve_threshold: 1000.00

    # Notification settings
    notifications:
        email_enabled: true
        sms_enabled: false

    # Order number generation
    order_number:
        prefix: 'PO'
        length: 10

Available Services

The bundle provides the following services:

tourze_purchase_manage.order_manager - Purchase order management
tourze_purchase_manage.approval_manager - Approval workflow management
tourze_purchase_manage.delivery_manager - Delivery tracking management
tourze_purchase_manage.notification_service - Notification service

Database Schema

The bundle creates the following database tables:

purchase_order - Main purchase orders
purchase_order_item - Individual order items
purchase_delivery - Delivery records
purchase_approval - Approval records

Events

The bundle dispatches the following events:

purchase_order.created - When a purchase order is created
purchase_order.updated - When a purchase order is updated
purchase_approval.created - When an approval is created
purchase_delivery.created - When a delivery is recorded

Testing

# Run the test suite
composer run test

# Run PHPStan analysis
composer run analyse

# Run all quality checks
composer run quality

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

License

This bundle is licensed under the MIT License. See the LICENSE file for details.

Support

For support and questions:

Create an issue in the GitHub repository
Check the documentation
Review existing issues for solutions

Changelog

See CHANGELOG.md for a list of changes and version history.

tourze / purchase-manage-bundle

Maintainers

Details