ConfigurationResource

A reference source held by an organisation — either an uploaded file or an external URL — optionally filed into a collection and linked to credits.

Purpose

The configuration estate is the body of source material an organisation makes available to the platform: corporate filings, press, internal HR documents, competitor analysis and industry trends. Each entry records where the material came from (source), how it is categorised, and which credits it supports. When the material is a file, attachment_id points at the stored Attachment.

Usage

Managed from both the client-facing configuration screens and the Filament admin.

• app/Http/Controllers/Configuration/ConfigurationStoreController.php, ConfigurationDestroyController.php, ConfigurationDownloadController.php — create, remove and download
• app/Services/ConfigurationEstateService.php — aggregates resources for the configuration view
• app/Filament/Resources/ConfigurationResourceResource.php and its bulk actions — staff administration, category and project assignment
• app/Filament/Resources/OrganizationResource/Actions/BulkUploadConfigurationResourcesAction.php — bulk upload
• app/Services/Voice/Tools/ListConfigurationResources.php — exposed to agents

Relationships

Relation	Type	Related model
organization	belongsTo	Organization
attachment	belongsTo	Attachment
collection	belongsTo	ConfigurationCollection
createdBy	belongsTo	User
updatedBy	belongsTo	User
projects	belongsToMany	Project

Data shape

Table: configuration_resources

Column	Type	Notes
id	uuid	Primary key
name	string	Resource title
tags	json	Nullable, cast to array
description	text	Nullable
category	string	Nullable, one of ConfigurationResource::CATEGORIES
url	string	Nullable, for link resources
organization_id	uuid	FK organizations, cascade delete
collection_id	uuid	Nullable, FK, null on delete
source	string	Default you
attachment_id	uuid	Nullable, FK, set null on delete
created_by, updated_by	uuid	FK users, restrict on delete
created_at, updated_at	timestamp	Nullable

Categories are corporate-filings, press, internal-hr, competitor-analysis and industry-trends. created_by and updated_by are set automatically from the authenticated user on create and update.