Download the PHP package tourze/hotel-agent-bundle without Composer
On this page you can find all versions of the php package tourze/hotel-agent-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package hotel-agent-bundle
hotel-agent-bundle
中文
Hotel agent management module for handling hotel distribution, agent accounts, orders, and billing.
Table of Contents
- Features
- Installation
- Quick Start
- Dependencies
- Usage
- Managing Agents
- Working with Orders
- Commands
- Agent Commands
- Bill Commands
- Configuration
- Advanced Usage
- Custom Agent Code Generation
- Bill Audit Workflow Customization
- Order Import with Custom Validation
- Entities
- Enums
- Services
- Events
- Admin Interface
- Testing
- License
Features
- Agent account management (creation, status management, commission rates)
- Hotel-agent mapping configuration
- Order management and processing
- Payment tracking and reconciliation
- Monthly billing generation and audit
- Comprehensive reporting and export capabilities
- EasyAdmin integration for backend management
Installation
Quick Start
-
Install the bundle:
-
Register the bundle in your Symfony application:
-
Update your database schema:
- Create your first agent:
Dependencies
This bundle requires the following packages:
- PHP 8.2+: Modern PHP features and performance
- Symfony 7.3+: Framework foundation
- Doctrine ORM 3.0+: Database abstraction and ORM
- EasyAdmin 4+: Admin interface
- PHPOffice/PhpSpreadsheet: Excel import/export functionality
Internal dependencies:
tourze/hotel-profile-bundle: Hotel and room type managementtourze/hotel-contract-bundle: Inventory and pricing contractstourze/doctrine-timestamp-bundle: Automatic timestamp handlingtourze/easy-admin-menu-bundle: Admin menu integration
Usage
Managing Agents
Working with Orders
Commands
The bundle provides several console commands for agent and billing management.
Agent Commands
agent:check-expired
Check and update expired agent account statuses.
Options:
--dry-run: Show what would be updated without making changes--days: Number of days to check for upcoming expirations (default: 7)
Bill Commands
app:generate-monthly-bills
Automatically generate monthly settlement bills for agents.
Arguments:
billMonth: Bill month in YYYY-MM format (optional, defaults to previous month)
Options:
--force, -f: Force regenerate existing bills--dry-run: Preview mode without creating actual bills
Recommended cron setup (run on the 1st of each month):
Configuration
The bundle automatically registers its services and entities. No additional configuration is required for basic usage.
Advanced Usage
Custom Agent Code Generation
Bill Audit Workflow Customization
Order Import with Custom Validation
Entities
- Agent: Represents hotel distribution agents with commission rates and status
- AgentBill: Monthly settlement bills for agents
- AgentHotelMapping: Maps agents to hotels they can sell
- Order: Hotel booking orders placed by agents
- OrderItem: Individual room bookings within an order
- Payment: Payment records for orders
- BillAuditLog: Audit trail for bill approvals and rejections
Enums
- AgentStatusEnum: ACTIVE, FROZEN, DISABLED, EXPIRED
- AgentLevelEnum: BRONZE, SILVER, GOLD, PLATINUM, DIAMOND
- BillStatusEnum: DRAFT, PENDING_AUDIT, AUDITED, REJECTED, PAID
- OrderStatusEnum: PENDING, CONFIRMED, CANCELLED, COMPLETED, CLOSED
- PaymentStatusEnum: PENDING, PROCESSING, SUCCESS, FAILED, REFUNDED
Services
- AgentBillService: Handles monthly bill generation and calculations
- BillAuditService: Manages bill approval workflow
- OrderCreationService: Creates orders with validation
- OrderStatusService: Manages order state transitions
- PaymentService: Processes payments and refunds
- OrderImportService: Imports orders from Excel files
- AgentCodeGenerator: Generates unique agent codes
Events
- Agent code auto-generation on creation
- Order item inventory synchronization
- Bill status change tracking
Admin Interface
The bundle provides EasyAdmin CRUD controllers for:
- Agent management
- Order management with bulk operations
- Payment tracking
- Bill approval workflow
- Comprehensive reporting dashboards
- Data export functionality
Testing
License
MIT
All versions of hotel-agent-bundle with dependencies
brick/math Version ^0.13
doctrine/collections Version ^2.3
doctrine/data-fixtures Version ^2.0
doctrine/dbal Version ^4.0
doctrine/doctrine-bundle Version ^2.13
doctrine/doctrine-fixtures-bundle Version ^4.0
doctrine/orm Version ^3.0
doctrine/persistence Version ^3.1 || ^4
easycorp/easyadmin-bundle Version ^4
knplabs/knp-menu Version ^3.7
phpoffice/phpspreadsheet Version ^3.9
psr/log Version ^3|^2|^1
symfony/config Version ^6.4
symfony/console Version ^6.4
symfony/dependency-injection Version ^6.4
symfony/doctrine-bridge Version ^6.4
symfony/form Version ^6.4
symfony/framework-bundle Version ^6.4
symfony/http-foundation Version ^6.4
symfony/http-kernel Version ^6.4
symfony/routing Version ^6.4
symfony/security-core Version ^6.4
symfony/yaml Version ^6.4 || ^7.1
tourze/doctrine-timestamp-bundle Version 0.0.*
tourze/doctrine-user-bundle Version 0.0.*
tourze/easy-admin-menu-bundle Version 0.1.*
tourze/enum-extra Version ~0.0.5
tourze/hotel-contract-bundle Version 0.0.*
tourze/hotel-profile-bundle Version 0.0.*
tourze/symfony-routing-auto-loader-bundle Version 0.0.*