README

Laravel Boost guidelines and skill for Odoo JSON-RPC development via obuchmann/odoo-jsonrpc.

Installation

composer require jouwnaam/odoo-connector

Then run the Boost installer to load the guidelines and skill into your agent:

php artisan boost:install

To update after a package update:

composer update jouwnaam/odoo-connector
php artisan boost:update

Or automate this in your project's composer.json:

{
    "scripts": {
        "post-update-cmd": [
            "@php artisan boost:update --ansi"
        ]
    }
}

What's included

• Laravel Boost guideline — critical rules loaded upfront into your agent's context
• Laravel Boost skill — odoo-development, full patterns loaded on demand

Project setup

After installing the package, set up the following in your project:

Register casts in AppServiceProvider::boot():

use Obuchmann\OdooJsonRpc\Odoo;
use Obuchmann\OdooJsonRpc\Odoo\Casts\DateTimeCast;

Odoo::registerCast(new DateTimeCast());

Add OdooNotFoundException to app/Odoo/Exceptions/:

namespace App\Odoo\Exceptions;

class OdooNotFoundException extends \RuntimeException {}

Register exceptions in bootstrap/app.php:

use Obuchmann\OdooJsonRpc\Exceptions\{AuthenticationException, OdooModelException};
use App\Odoo\Exceptions\OdooNotFoundException;

->withExceptions(function (Exceptions $exceptions) {
    $exceptions->render(function (OdooNotFoundException $e) {
        return response()->json(['message' => $e->getMessage()], 404);
    });
    $exceptions->render(function (OdooModelException $e) {
        report($e);
        return response()->json(['message' => 'Odoo operation failed.'], 422);
    });
    $exceptions->render(function (AuthenticationException $e) {
        report($e);
        return response()->json(['message' => 'Odoo authentication failed.'], 503);
    });
})

See the odoo-development skill for full patterns and examples.