Download the PHP package tourze/wechat-mini-program-insurance-freight-bundle without Composer

WeChat Mini Program Insurance Freight Bundle

中文

A comprehensive Symfony bundle that integrates WeChat Mini Program freight insurance functionality, providing seamless order management, return processing, and automated data synchronization with WeChat APIs.

Table of Contents

• Features
• Requirements
• Installation
• Quick Start
• Console Commands
• Architecture
• Advanced Usage
• Configuration
• Testing
• Security
• Contributing
• Changelog
• License

Features

• Insurance Order Management: Complete lifecycle management of freight insurance orders
• Return Order Processing: Automated handling of return orders with status tracking
• Data Synchronization: Real-time synchronization with WeChat APIs
• Summary Statistics: Comprehensive reporting and analytics
• Command-Line Tools: Automated tasks and manual operations via console commands
• Admin Interface: EasyAdmin-powered administrative controllers for data management
• Event-Driven Architecture: Flexible event subscribers for custom business logic
• Repository Pattern: Clean data access layer with custom repositories

Requirements

• PHP 8.1 or higher
• Symfony 6.4 or higher
• Doctrine ORM 3.0 or higher
• WeChat Mini Program Bundle ecosystem

Installation

Bundle Registration

Add the bundle to your config/bundles.php:

Quick Start

Basic Usage

Entity Usage

Console Commands

This bundle provides several console commands for managing freight insurance:

Data Synchronization Commands

wechat-insurance:get-summary

Fetches summary data from WeChat API.

• Schedule: Runs every 6 hours (30 /6 )
• Description: Pulls summary interface data for the last 3 days

wechat-insurance:sync-insurance-order-list

Synchronizes insurance orders to local database.

• Schedule: Runs every 15 minutes (/15 *)
• Description: Fetches insurance order information from WeChat API and stores locally

wechat-insurance:sync-valid-return-orders

Synchronizes all valid return orders to local database.

• Schedule: Runs every 15 minutes (/15 *)
• Description: Synchronizes valid return order information to local storage

Manual Operation Commands

wechat-insurance:query-open

Queries the opening status of freight insurance.

• Usage: php bin/console wechat-insurance:query-open
• Description: Checks the opening status for all valid accounts

wechat-insurance:sync-single-return-order

Synchronizes a single return order to local database.

• Usage: php bin/console wechat-insurance:sync-single-return-order <shopOrderId>
• Arguments:
  • shopOrderId: Internal return order ID used by the merchant system
• Description: Synchronizes individual return order information to local storage

wechat-insurance:unbind-return-order

Unbinds a single return order.

• Usage: php bin/console wechat-insurance:unbind-return-order <shopOrderId>
• Arguments:
  • shopOrderId: Internal return order ID used by the merchant system
• Description: Unbinds individual return order information

Architecture

Entities

• InsuranceOrder: Core entity managing insurance order data with lifecycle tracking
• ReturnOrder: Manages return order information and status updates
• Summary: Stores aggregated statistics and reporting data

Services

• InsuranceFreightService: Main service class handling all freight insurance operations
  • Order creation and management
  • Return order processing
  • Data synchronization with WeChat APIs

Event Subscribers

• InsuranceOrderListener: Handles pre-persist events for insurance orders
• ProcessingEventSubscriber: Manages order processing events

Repositories

• InsuranceOrderRepository: Provides data access methods for insurance orders
• ReturnOrderRepository: Handles return order data operations
• SummaryRepository: Manages summary and statistics data

Advanced Usage

Custom Event Subscribers

Repository Usage

Configuration

Environment Variables

Bundle Configuration

Create config/packages/wechat_mini_program_insurance_freight.yaml:

Testing

Run the test suite:

Security

Reporting Security Vulnerabilities

If you discover a security vulnerability, please send an email to [email protected]. All security vulnerabilities will be promptly addressed.

Security Best Practices

• Always validate input data before processing
• Use HTTPS for all API communications
• Implement proper rate limiting
• Regularly update dependencies
• Monitor for unusual activity patterns

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests.

Development Setup

Changelog

All notable changes to this project will be documented in CHANGELOG.md.

License

This project is licensed under the MIT License - see the LICENSE file for details.