ICT:FinalConfig - Asset - v1

Final Configuration for the Asset Entity (v1 – No Numbering)

Document revision: 2026-02-20 by Mngr

This document defines the first stable implementation of the Asset entity. This version deliberately excludes automatic numbering, Lua modules, and JavaScript.

The objective of Asset v1 is to validate: - entity structure - foreign keys - recursion - dashboard interaction - strict alignment with Chapter, Place, and Organisation

Automatic numbering and deterministic identifiers will be introduced in a later version once the structural baseline is validated.

---

Design Principles

The Asset entity follows the same non-negotiable rules as other core entities:

• The page name is the immutable technical identifier (**Code**)
• All relations use the page name as foreign key
• Label is the human-readable name and may change
• All interaction happens via dashboards and forms
• Pages are configuration records and must not be browsed directly
• Explicit configuration is preferred over implicit automation

---

Cargo Table

Template:Asset

<noinclude>
Asset data template (v1 – no numbering)

{{#cargo_declare:
 |_table=Assets
 |Code=Page
 |Label=String
 |Chapter=Page
 |Place=Page
 |Organisation=Page
 |Parent=Page
 |AssetSourceType=Page
 |AssetType=Page
 |File=String
 |Language=String
 |Description=Text
 |Notes=Text
 |AIProcessed=Boolean
 |CitationText=Text
 |Permalink=String
 |Repository=String
 |Rights=String
 |IsPublishable=Boolean
}}
</noinclude>

{{#cargo_store:
 |Code={{FULLPAGENAME}}
 |Label={{{Label|}}}
 |Chapter={{{Chapter|}}}
 |Place={{{Place|}}}
 |Organisation={{{Organisation|}}}
 |Parent={{{Parent|}}}
 |AssetSourceType={{{AssetSourceType|}}}
 |AssetType={{{AssetType|}}}
 |File={{{File|}}}
 |Language={{{Language|}}}
 |Description={{{Description|}}}
 |Notes={{{Notes|}}}
 |AIProcessed={{{AIProcessed|}}}
 |CitationText={{{CitationText|}}}
 |Permalink={{{Permalink|}}}
 |Repository={{{Repository|}}}
 |Rights={{{Rights|}}}
 |IsPublishable={{{IsPublishable|}}}
}}

== {{{Label|{{PAGENAME}}}}} ==
{{DISPLAYTITLE:{{{Label|{{PAGENAME}}}}}}}

Once the template is created, the Cargo table must be created manually. If the table structure is modified, the table must be recreated and swapped via the Cargo administration interface.

The field Code stores the full page name (including namespace) and acts as the stable technical identifier used for all relations.

---

Page Form

Form:Asset

<noinclude>
Form for creating and editing Asset pages (v1).
</noinclude>

{{{info
 |no summary
 |no preview
 |no minor edit
 |no watch
 |no footer
}}}

''Fields marked with (*) are required.''

{{{for template|Asset}}}

{| class="formtable"

! Code
| {{PAGENAME}}
|-

! Label
| {{{field|Label}}}
|-

! Chapter (*)
| {{{field|Chapter
   |input type=combobox
   |values from namespace=Chapter
   |existing values only
}}}
|-

! Place
| {{{field|Place
   |input type=combobox
   |values from namespace=Place
   |existing values only
   |placeholder=Optional – leave empty if using Organisation
}}}
|-

! Organisation
| {{{field|Organisation
   |input type=combobox
   |values from namespace=Organisation
   |existing values only
   |placeholder=Optional – leave empty if using Place
}}}
|-

! Parent asset
| {{{field|Parent
   |input type=combobox
   |values from namespace=Asset
   |existing values only
   |placeholder=Top level (no parent)
}}}
|-

! Asset source type
| {{{field|AssetSourceType
   |input type=combobox
   |values from namespace=AssetSourceType
   |existing values only
}}}
|-

! Asset type
| {{{field|AssetType
   |input type=combobox
   |values from namespace=AssetType
   |existing values only
}}}
|-

! File
| {{{field|File
   |input type=page
   |namespace=File
   |uploadable=yes
   |placeholder=Click “Upload file” to select a file
}}}
|-

! Language
| {{{field|Language|input type=text|size=20}}}
|-

! Description
| {{{field|Description|input type=textarea}}}
|-

! Notes
| {{{field|Notes|input type=textarea}}}
|-

! AI processed
| {{{field|AIProcessed|input type=checkbox}}}
|-

! Citation text
| {{{field|CitationText|input type=textarea}}}
|-

! Permalink
| {{{field|Permalink|input type=text|size=60}}}
|-

! Repository
| {{{field|Repository|input type=text|size=60}}}
|-

! Rights
| {{{field|Rights|input type=text|size=60}}}
|-

! Publishable
| {{{field|IsPublishable|input type=checkbox}}}

|}

{{{standard input|save}}}

{{{end template}}}

The Page Form deliberately avoids: - automatic page name generation - JavaScript logic - automatic validation

Mandatory requirements are communicated via text and user discipline in v1.

---

🗂️ Costa Sano Research ASSET Dashboard

📖 Need Help?

Code	Label	Chapter	Place	Organisation	Type
20260222193244	CH00	ALTO		{{{File}}}
20260222202132	CH00	ALTO		{{{File}}}
20260222203155	CH01	AMER		{{{File}}}
20260222222722	CH02	BRUG		{{{File}}}

Choose an asset code corresponding to the table above and respecting the naming conventions.

Last updated: 22 July 2026 – 23:24 UTC

🗂️ Costa Sano Research ASSET Dashboard

📖 Need Help?

Code	Label	Chapter	Place	Organisation	Type
20260222193244	CH00	ALTO		{{{File}}}
20260222202132	CH00	ALTO		{{{File}}}
20260222203155	CH01	AMER		{{{File}}}
20260222222722	CH02	BRUG		{{{File}}}

Choose an asset code corresponding to the table above and respecting the naming conventions.

Last updated: 22 July 2026 – 23:24 UTC

Example Asset Page (v1)

{{Asset
 |Label=Photograph – Early Costa Sano activities
 |Chapter=Chapter:CH03
 |Place=Place:BERCK
 |Organisation=
 |AssetType=AssetType:Photo
 |File=File:example.jpg
 |Description=Photograph of early Costa Sano activities.
 |Notes=Scanned from original archive.
 |AIProcessed=true
 |IsPublishable=true
}}

This page is a configuration record and must be accessed via the dashboard.

---

Status

This document defines **Asset v1**.

Automatic numbering, deterministic identifiers, Lua modules, and JavaScript will be introduced in a future version after structural validation.

MediaWiki Architecture Note

In MediaWiki, file uploads, form inputs, and structured storage are handled by different subsystems that are not transactionally coupled.

Key implications for the Asset entity (v1):

• Page Forms file uploads are page-based.

 The reliable upload mechanism is a page selector
 in the File namespace with upload enabled.

• Cargo fields of type Page assume that the referenced page

 already exists at the time of storage.
 This assumption does not hold for newly uploaded files.

• Using a Cargo field of type Page for files may therefore lead to

 non-deterministic storage (race conditions) when creating records
 and uploading files in a single form submission.

• To guarantee deterministic behavior in v1, file references are:

 - selected and uploaded via Page Forms as File namespace pages
 - stored in Cargo as plain strings (file page titles)

This separation avoids race conditions while preserving a clean upgrade path for future normalization or automation.