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.
• Data Packages MCP for assessing what the published data packages contain, and how versions differ.

Current development posture

The Filament 3 panel at /admin is the application’s only UI, and / redirects to it. Back-office work, including sign-in, registration and account pages, belongs there.

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.