docs:Create a Comprehensive API Reference Guide for Inventory Sync #12

[CoolatMax]

This PR resolves critical environment blockers in the GitHub Codespace and establishes the testing foundation for the AI-Powered Inventory Sync solution. It ensures that the PHP environment is compatible with the latest Ubuntu distribution and verifies that the core authentication middleware—required for the API endpoints—is functional.

2. Changes Made

Infrastructure & Environment

• Resolved OpenSSL Dependency: Manually patched libssl1.1 to fix the OPENSSL_1_1_1 not found error prevalent in Ubuntu 24.04 (Noble) environments.

• Service Initialization: Configured and started PostgreSQL and Redis services to support the documented database and queue drivers.

• Dependency Management: Synchronized PHP (composer) and Node (npm) packages to ensure the vendor and node_modules directories are correctly populated.

Testing & Validation

• Core Authentication Verified: Successfully ran 26 feature tests covering Authentication, Registration, and Profile settings.

• NPM Scripting: Added the missing "test": "vitest" script to package.json to allow frontend/unit testing as specified in the README.md.

3. Verification Results

• PHP Version: php -v now executes without shared library errors.

• Test Suite: > Tests: 26 passed (63 assertions)

  Duration: 1.66s

• Service Health: Verified Redis via redis-cli ping (PONG) and PostgreSQL via service status.

4. Known Issues / Next Steps

• Route Registration: While core routes are active, the specific /api/inventory/* routes defined in API-reference.md need to be formally registered in routes/api.php to appear in php artisan route:list.

Close Issue #12