This commit is contained in:
2026-09-15 10:35:56 +08:00
commit 782f8ea7aa
4086 changed files with 631288 additions and 0 deletions
+12
View File
@@ -0,0 +1,12 @@
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:framework:Acl/etc/acl.xsd">
<acl>
<resources>
<resource id="Magento_Backend::admin">
<resource id="Esun_SeventeenTrack::config" title="Configure 17TRACK" sortOrder="90"/>
<resource id="Esun_SeventeenTrack::logs" title="View 17TRACK API Logs" sortOrder="91"/>
</resource>
</resources>
</acl>
</config>
@@ -0,0 +1,11 @@
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Backend:etc/menu.xsd">
<menu>
<add id="Esun_SeventeenTrack::root" title="17TRACK" module="Esun_SeventeenTrack"
sortOrder="90" parent="Esun_ImageManager::esun" resource="Esun_SeventeenTrack::logs"/>
<add id="Esun_SeventeenTrack::logs" title="API Logs" module="Esun_SeventeenTrack"
sortOrder="10" parent="Esun_SeventeenTrack::root" action="esun_seventeen_track/log/index"
resource="Esun_SeventeenTrack::logs"/>
</menu>
</config>
@@ -0,0 +1,9 @@
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:framework:App/etc/routes.xsd">
<router id="admin">
<route id="esun_seventeen_track" frontName="esun_seventeen_track">
<module name="Esun_SeventeenTrack" before="Magento_Backend"/>
</route>
</router>
</config>
@@ -0,0 +1,25 @@
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
<system>
<section id="esun_seventeen_track" translate="label" sortOrder="170" showInDefault="1" showInWebsite="0" showInStore="0">
<label>17TRACK</label><tab>esun</tab><resource>Esun_SeventeenTrack::config</resource>
<group id="general" translate="label" sortOrder="10" showInDefault="1" showInWebsite="0" showInStore="0">
<label>API Connection</label>
<field id="enabled" translate="label" type="select" sortOrder="10" showInDefault="1" showInWebsite="0" showInStore="0"><label>Enabled</label><source_model>Magento\Config\Model\Config\Source\Yesno</source_model></field>
<field id="api_url" translate="label" type="text" sortOrder="20" showInDefault="1" showInWebsite="0" showInStore="0"><label>API Base URL</label></field>
<field id="api_key" translate="label comment" type="obscure" sortOrder="30" showInDefault="1" showInWebsite="0" showInStore="0"><label>API Key</label><backend_model>Magento\Config\Model\Config\Backend\Encrypted</backend_model><comment>Stored encrypted. It is only sent to api.17track.net in the 17token request header.</comment></field>
</group>
<group id="sync" translate="label" sortOrder="20" showInDefault="1" showInWebsite="0" showInStore="0">
<label>Delivery Synchronization</label>
<field id="batch_size" translate="label comment" type="text" sortOrder="10" showInDefault="1" showInWebsite="0" showInStore="0"><label>Batch Size</label><comment>Maximum 40, matching the 17TRACK API limit.</comment></field>
<field id="auto_receive" translate="label comment" type="select" sortOrder="20" showInDefault="1" showInWebsite="0" showInStore="0"><label>Mark Orders Received Automatically</label><source_model>Magento\Config\Model\Config\Source\Yesno</source_model><comment>When every tracking number on a shipped order is Delivered, change its status to Received.</comment></field>
</group>
<group id="widget" translate="label" sortOrder="30" showInDefault="1" showInWebsite="0" showInStore="0">
<label>Customer Order Widget</label>
<field id="enabled" translate="label" type="select" sortOrder="10" showInDefault="1" showInWebsite="0" showInStore="0"><label>Enabled</label><source_model>Magento\Config\Model\Config\Source\Yesno</source_model></field>
<field id="height" translate="label comment" type="text" sortOrder="20" showInDefault="1" showInWebsite="0" showInStore="0"><label>Widget Height</label><comment>From 200 to 800 pixels.</comment></field>
</group>
</section>
</system>
</config>
@@ -0,0 +1,11 @@
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Store:etc/config.xsd">
<default>
<esun_seventeen_track>
<general><enabled>0</enabled><api_url>https://api.17track.net/track/v2.4</api_url></general>
<sync><batch_size>40</batch_size><auto_receive>1</auto_receive></sync>
<widget><enabled>1</enabled><height>560</height></widget>
</esun_seventeen_track>
</default>
</config>
@@ -0,0 +1,6 @@
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Cron:etc/crontab.xsd">
<group id="default">
<job name="esun_seventeen_track_sync" instance="Esun\SeventeenTrack\Cron\SyncTracking" method="execute"><schedule>*/10 * * * *</schedule></job>
</group>
</config>
@@ -0,0 +1,9 @@
<?xml version="1.0"?>
<csp_whitelist xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Csp:etc/csp_whitelist.xsd">
<policies>
<policy id="script-src"><values><value id="17track-script" type="host">https://www.17track.net</value></values></policy>
<policy id="frame-src"><values><value id="17track-frame" type="host">https://*.17track.net</value></values></policy>
<policy id="connect-src"><values><value id="17track-connect" type="host">https://*.17track.net</value></values></policy>
<policy id="style-src"><values><value id="17track-style" type="host">https://*.17track.net</value></values></policy>
</policies>
</csp_whitelist>
@@ -0,0 +1,58 @@
<?xml version="1.0"?>
<schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:framework:Setup/Declaration/Schema/etc/schema.xsd">
<table name="esun_seventeen_track" resource="sales" engine="innodb" comment="17TRACK Shipment Status">
<column xsi:type="int" name="entity_id" unsigned="true" nullable="false" identity="true" comment="ID"/>
<column xsi:type="int" name="shipment_track_id" unsigned="true" nullable="false" comment="Magento Shipment Track ID"/>
<column xsi:type="int" name="shipment_id" unsigned="true" nullable="false" comment="Shipment ID"/>
<column xsi:type="int" name="order_id" unsigned="true" nullable="false" comment="Order ID"/>
<column xsi:type="varchar" name="tracking_number" nullable="false" length="50" comment="Tracking Number"/>
<column xsi:type="int" name="carrier_code" unsigned="true" nullable="true" comment="17TRACK Carrier Code"/>
<column xsi:type="varchar" name="sync_status" nullable="false" length="20" default="pending" comment="Sync Status"/>
<column xsi:type="int" name="error_code" nullable="true" comment="Last 17TRACK Error Code"/>
<column xsi:type="smallint" name="attempt_count" unsigned="true" nullable="false" default="0" comment="Consecutive Failure Count"/>
<column xsi:type="timestamp" name="next_attempt_at" nullable="true" on_update="false" comment="Next Attempt Time"/>
<column xsi:type="varchar" name="package_status" nullable="true" length="40" comment="17TRACK Package Status"/>
<column xsi:type="varchar" name="latest_event" nullable="true" length="1024" comment="Latest Tracking Event"/>
<column xsi:type="timestamp" name="delivered_at" nullable="true" on_update="false" comment="Delivery Time"/>
<column xsi:type="text" name="last_error" nullable="true" comment="Last Error"/>
<column xsi:type="mediumtext" name="response_data" nullable="true" comment="Last API Response"/>
<column xsi:type="timestamp" name="last_synced_at" nullable="true" on_update="false" comment="Last Sync Time"/>
<column xsi:type="timestamp" name="created_at" nullable="false" default="CURRENT_TIMESTAMP" on_update="false" comment="Created At"/>
<column xsi:type="timestamp" name="updated_at" nullable="false" default="CURRENT_TIMESTAMP" on_update="true" comment="Updated At"/>
<constraint xsi:type="primary" referenceId="PRIMARY"><column name="entity_id"/></constraint>
<constraint xsi:type="unique" referenceId="ESUN_17TRACK_SHIPMENT_TRACK_UNQ"><column name="shipment_track_id"/></constraint>
<constraint xsi:type="foreign" referenceId="ESUN_17TRACK_SHIPMENT_TRACK_FK" table="esun_seventeen_track" column="shipment_track_id" referenceTable="sales_shipment_track" referenceColumn="entity_id" onDelete="CASCADE"/>
<constraint xsi:type="foreign" referenceId="ESUN_17TRACK_SHIPMENT_FK" table="esun_seventeen_track" column="shipment_id" referenceTable="sales_shipment" referenceColumn="entity_id" onDelete="CASCADE"/>
<constraint xsi:type="foreign" referenceId="ESUN_17TRACK_ORDER_FK" table="esun_seventeen_track" column="order_id" referenceTable="sales_order" referenceColumn="entity_id" onDelete="CASCADE"/>
<index referenceId="ESUN_17TRACK_SYNC_STATUS" indexType="btree"><column name="sync_status"/></index>
<index referenceId="ESUN_17TRACK_NEXT_ATTEMPT" indexType="btree"><column name="next_attempt_at"/></index>
<index referenceId="ESUN_17TRACK_ORDER_STATUS" indexType="btree"><column name="order_id"/><column name="package_status"/></index>
</table>
<table name="esun_seventeen_track_api_log" resource="sales" engine="innodb" comment="17TRACK API Audit Log">
<column xsi:type="bigint" name="entity_id" unsigned="true" nullable="false" identity="true" comment="Entity ID"/>
<column xsi:type="varchar" name="direction" nullable="false" length="10" comment="Inbound or Outbound"/>
<column xsi:type="varchar" name="operation" nullable="false" length="30" comment="API Operation"/>
<column xsi:type="varchar" name="api_path" nullable="true" length="255" comment="API Endpoint"/>
<column xsi:type="varchar" name="batch_id" nullable="true" length="32" comment="Batch Correlation ID"/>
<column xsi:type="int" name="order_id" unsigned="true" nullable="true" comment="Magento Order ID"/>
<column xsi:type="varchar" name="order_number" nullable="true" length="50" comment="Magento Order Number"/>
<column xsi:type="varchar" name="tracking_number" nullable="true" length="50" comment="Tracking Number"/>
<column xsi:type="varchar" name="event" nullable="true" length="50" comment="Webhook Event"/>
<column xsi:type="varchar" name="status" nullable="false" length="20" comment="Result Status"/>
<column xsi:type="smallint" name="http_status" unsigned="true" nullable="true" comment="HTTP Status"/>
<column xsi:type="int" name="error_code" nullable="true" comment="17TRACK Error Code"/>
<column xsi:type="text" name="message" nullable="true" comment="Result or Error Message"/>
<column xsi:type="mediumtext" name="request_data" nullable="true" comment="Sanitized Request Data"/>
<column xsi:type="mediumtext" name="response_data" nullable="true" comment="Sanitized Response Data"/>
<column xsi:type="int" name="duration_ms" unsigned="true" nullable="true" comment="Duration Milliseconds"/>
<column xsi:type="timestamp" name="created_at" nullable="false" default="CURRENT_TIMESTAMP" on_update="false" comment="Created At"/>
<constraint xsi:type="primary" referenceId="PRIMARY"><column name="entity_id"/></constraint>
<index referenceId="ESUN_17TRACK_API_LOG_STATUS_CREATED" indexType="btree"><column name="status"/><column name="created_at"/></index>
<index referenceId="ESUN_17TRACK_API_LOG_OPERATION_CREATED" indexType="btree"><column name="operation"/><column name="created_at"/></index>
<index referenceId="ESUN_17TRACK_API_LOG_ORDER" indexType="btree"><column name="order_number"/></index>
<index referenceId="ESUN_17TRACK_API_LOG_TRACKING" indexType="btree"><column name="tracking_number"/></index>
<index referenceId="ESUN_17TRACK_API_LOG_BATCH" indexType="btree"><column name="batch_id"/></index>
</table>
</schema>
@@ -0,0 +1 @@
{"esun_seventeen_track":{"column":{"entity_id":true,"shipment_track_id":true,"shipment_id":true,"order_id":true,"tracking_number":true,"carrier_code":true,"sync_status":true,"error_code":true,"attempt_count":true,"next_attempt_at":true,"package_status":true,"latest_event":true,"delivered_at":true,"last_error":true,"response_data":true,"last_synced_at":true,"created_at":true,"updated_at":true},"constraint":{"PRIMARY":true,"ESUN_17TRACK_SHIPMENT_TRACK_UNQ":true,"ESUN_17TRACK_SHIPMENT_TRACK_FK":true,"ESUN_17TRACK_SHIPMENT_FK":true,"ESUN_17TRACK_ORDER_FK":true},"index":{"ESUN_17TRACK_SYNC_STATUS":true,"ESUN_17TRACK_NEXT_ATTEMPT":true,"ESUN_17TRACK_ORDER_STATUS":true}},"esun_seventeen_track_api_log":{"column":{"entity_id":true,"direction":true,"operation":true,"api_path":true,"batch_id":true,"order_id":true,"order_number":true,"tracking_number":true,"event":true,"status":true,"http_status":true,"error_code":true,"message":true,"request_data":true,"response_data":true,"duration_ms":true,"created_at":true},"constraint":{"PRIMARY":true},"index":{"ESUN_17TRACK_API_LOG_STATUS_CREATED":true,"ESUN_17TRACK_API_LOG_OPERATION_CREATED":true,"ESUN_17TRACK_API_LOG_ORDER":true,"ESUN_17TRACK_API_LOG_TRACKING":true,"ESUN_17TRACK_API_LOG_BATCH":true}}}
+24
View File
@@ -0,0 +1,24 @@
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
<type name="Magento\Framework\Console\CommandListInterface">
<arguments>
<argument name="commands" xsi:type="array">
<item name="esunSeventeenTrackSync" xsi:type="object">Esun\SeventeenTrack\Console\Command\SyncCommand</item>
</argument>
</arguments>
</type>
<type name="Magento\Framework\View\Element\UiComponent\DataProvider\CollectionFactory">
<arguments>
<argument name="collections" xsi:type="array">
<item name="esun_seventeen_track_log_listing_data_source" xsi:type="string">EsunSeventeenTrackLogGridCollection</item>
</argument>
</arguments>
</type>
<virtualType name="EsunSeventeenTrackLogGridCollection" type="Magento\Framework\View\Element\UiComponent\DataProvider\SearchResult">
<arguments>
<argument name="mainTable" xsi:type="string">esun_seventeen_track_api_log</argument>
<argument name="resourceModel" xsi:type="string">Esun\SeventeenTrack\Model\ResourceModel\ApiLog</argument>
</arguments>
</virtualType>
</config>
@@ -0,0 +1,4 @@
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Event/etc/events.xsd">
<event name="sales_order_shipment_track_save_after"><observer name="esun_seventeen_track_enqueue" instance="Esun\SeventeenTrack\Observer\EnqueueTrack"/></event>
</config>
@@ -0,0 +1,9 @@
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:framework:App/etc/routes.xsd">
<router id="standard">
<route id="seventeentrack" frontName="seventeentrack">
<module name="Esun_SeventeenTrack"/>
</route>
</router>
</config>
@@ -0,0 +1,13 @@
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
<module name="Esun_SeventeenTrack">
<sequence>
<module name="Magento_Sales"/>
<module name="Magento_Config"/>
<module name="Magento_AdminNotification"/>
<module name="Esun_Customer"/>
<module name="Esun_ImageManager"/>
</sequence>
</module>
</config>