liberu-real-estate / real-estate-laravel

Real Estate / Estate Agent, solution for your Property Agency. Application written in Laravel 11 / PHP 8.3 using Filament 3
https://www.facebook.com/liberusoftware
40 stars 21 forks source link

Zoopla portal api #33

Closed curtisdelicata closed 3 months ago

curtisdelicata commented 1 year ago

Here's a detailed description of a GitHub issue for implementing Zoopla.co.uk portal upload and syncing properties with the Laravel 11/Filament 3 database:


Title: Implement Zoopla.co.uk Portal Upload and Sync for Properties in Laravel 11/Filament 3 Database

Description:

We need to implement functionality to upload properties from our Laravel 11 and Filament 3-based real estate application to Zoopla.co.uk, as well as sync property data between our application and the Zoopla portal. This should include initial data upload, periodic syncs, and handling updates/deletions.

Requirements:

  1. Zoopla API Integration:

    • Integrate with the Zoopla Real Time Listings (RTL) API for uploading and syncing properties.
    • Ensure authentication and authorization with the Zoopla API.
  2. Property Data Preparation:

    • Prepare property data in the format required by Zoopla.
    • Map our database fields to the required Zoopla fields.
    • Include necessary fields such as property type, description, price, address, images, etc.
  3. Initial Upload:

    • Implement functionality to perform an initial upload of all existing properties to Zoopla.
    • Provide a user interface in Filament 3 for triggering the initial upload.
  4. Periodic Sync:

    • Implement a scheduled task to sync property data periodically.
    • Sync new properties, updates to existing properties, and handle deletions.
    • Ensure that changes in our database are reflected on Zoopla and vice versa.
  5. Error Handling and Logging:

    • Implement robust error handling for API errors, data validation issues, and network problems.
    • Log errors and sync status for monitoring and troubleshooting.
    • Provide user-friendly error messages and feedback on the sync status.
  6. Admin Interface:

    • Add a section in the Filament 3 admin panel to manage Zoopla integration settings.
    • Include options for configuring API credentials, sync frequency, and viewing sync logs.
  7. Data Validation:

    • Validate property data before sending to Zoopla to ensure it meets their requirements.
    • Provide feedback on any data issues that need to be resolved before upload/sync.
  8. Notifications:

    • Implement notifications for successful uploads/syncs and for any errors that occur during the process.
    • Notify administrators about the sync status via email or through the Filament 3 admin panel.

Additional Information:

Acceptance Criteria:

References:

Labels:


Feel free to ask if you need further details or modifications.

sweep-ai[bot] commented 5 months ago
Sweeping

0%
💎 Sweep Pro: You have unlimited Sweep issues

Actions


[!TIP] To recreate the pull request, edit the issue title or description.