Collaborator Guide

This section orients developers and technical collaborators in the current codebase. It points back to the customer-facing model documentation to keep business concepts in one place.

Read first

Start with Inventory Principles and Core Model. Those pages define the terms used in code and tests.

Then use these pages by task:

• Codebase Map for repository structure.
• Filament Back-Office for /admin work.
• Importer Orientation for legacy migration work.
• APIs and Documentation for management API, OpenAPI, generated client, and Jekyll documentation work.
• Development Workflow for setup and validation commands.

Current development posture

Filament 3 is the main UI. The older /web Blade/Livewire back-office is legacy and scheduled for removal. New back-office work belongs in /admin unless an issue explicitly says otherwise.

The management API remains maintained. The read-only API is a future design area and should not be confused with the current authenticated management API.