ICT:Drupal Blueprint - Version 6.5 - Revision history

Mngr at 10:51, 23 March 2026

2026-03-23T10:51:15Z

← Older revision		Revision as of 10:51, 23 March 2026
Line 237:		Line 237:
	Now Code is a classic field and the Title field is a Caption field. This is a short description of the file.		Now Code is a classic field and the Title field is a Caption field. This is a short description of the file.

	== Next Major step: ~~HeritageObject and~~ Person ==		== Next Major step: Person and HeritageObject and the m-m relationship with Asset ==

	~~Now that Chapter, Place, Organisation~~ and ~~Asset are stable it is time for a next major step.~~
	HeritageObject~~, Drupal called Object, is the next challenge due to~~ the ~~fact it has a many to many~~ relationship with Asset,
	~~is recursive and also linked to a serious number of other entities. One of these is Person, not yet prepared for. This will be the first next step.~~

	=== Step 5: Person implementation ===		=== Step 5: Person implementation ===
Line 277:		Line 273:
	- both modules are implemented in heritage-tweaks		- both modules are implemented in heritage-tweaks
	- first view operational		- first view operational
	ToDo: ~~Nihil for time being~~		ToDo: refinement

	=== Step 6: HeritageObject implementation ===		=== Step 6: HeritageObject implementation ===
Line 321:		Line 317:
	- Onject is recursive		- Onject is recursive

	~~ToDO~~		ToDo
	- implementation of a many to many relationship between Object and Asset		- implementation of a many to many relationship between Object and Asset
	- One digital Asset is a prefered Asset only for illustration purposes of the Object in a view		- One digital Asset is a prefered Asset only for illustration purposes of the Object in a view
Line 330:		Line 326:
	* Custom Content Entities		* Custom Content Entities
	* Role-based relationships		* Role-based relationships
			* other many-to-many relationships

	----		----

Mngr at 10:46, 23 March 2026

2026-03-23T10:46:28Z

← Older revision		Revision as of 10:46, 23 March 2026
Line 86:		Line 86:

	=== Infrastructure ===		=== Infrastructure ===
	* Reverse Proxy: Windows Server (IIS + ARR, SSL offloading)		* Reverse Proxy: Windows Server 2019 (IIS + ARR, SSL offloading)
	* Web Server: AlmaLinux 10.1 (Apache 2.4.63, PHP 8.3.29, PHP-FPM)		* Web Server: AlmaLinux 10.1 (Apache 2.4.63, PHP 8.3.29, PHP-FPM)
	* Database Server: AlmaLinux 10.1 (MariaDB 10.11.15)		* Database Server: AlmaLinux 10.1 (MariaDB 10.11.15)
Line 140:		Line 140:

	Authority entities are implemented progressively, from simplest to most complex.		Authority entities are implemented progressively, from simplest to most complex.
	~~This order is mandatory.~~

	----		----
Line 373:		Line 372:
	* no massive tables		* no massive tables

	Status: Done, ~~but some refining necessary to deal~~ with massive amounts of assets.		Status: Done,
			Refining realised dealing with massive amounts of assets: using a combined field filter.

	----		----
Line 386:		Line 386:
	Mechanisms:		Mechanisms:
	* field descriptions		* field descriptions
	* ℹ️ icons		* ℹ️ icons (difficult in Drupal - placeholders may help here)
	* collapsible help sections		* collapsible help sections
			* TBD?: link to MediaWiki Reasearch namespace for extended documentation and system philosophy desccription
	~~No separate manuals.~~

	----		----
Line 396:		Line 395:

	Automation is handled via:		Automation is handled via:
	* Drupal configuration		* Drupal configuration and extra available modules
	* Custom ~~module~~		* Custom modules if really necessary, and simplifying a lot the implementation
			* take care: using drupal 11.3 - based on new (OO) concepts - needs special attention in building custom modules
	~~Status~~: ~~DONE but some refinements might be needed~~

	Automation is used to:		Automation is used to:
Line 435:		Line 433:
	* making the requirement work is the most important step, sysop will documenent once a milestone is achieved.		* making the requirement work is the most important step, sysop will documenent once a milestone is achieved.
	* AI will suggest a synthesis in mediawikitext format on sysop request to feed the documentation		* AI will suggest a synthesis in mediawikitext format on sysop request to feed the documentation


	----		----
Line 457:		Line 454:
	Decisions:		Decisions:
	* GIN skin is used for administration and user input in mandatory DARK mode.		* GIN skin is used for administration and user input in mandatory DARK mode.
	] SOLO skin is used for public pages.		* SOLO skin is used for public pages.

	----		----
Line 471:		Line 468:
	==== Mandatory Requirements ====		==== Mandatory Requirements ====
	* '''Permanent dark mode''' is used via the GIN skin/template		* '''Permanent dark mode''' is used via the GIN skin/template
	* No custom CSS or hacks		* Preferred no custom CSS or hacks

	==== Scope ====		==== Scope ====
Line 487:		Line 484:
	** low-contrast-stress		** low-contrast-stress
	** uncluttered		** uncluttered
	* No experimental or unstable admin themes are permitted

	----		----
Line 534:		Line 530:
	field "Description" - ch_description -- field_ch_description		field "Description" - ch_description -- field_ch_description

	== Implementation Status - March ~~7th~~ 2026) ==		Due to limitation in Drupal concerning the Data and Time widget, a plain text field is used for "day"..
			A custom module checks the format DD/MM/YYY and the field is limited to 10 chars, explanation about the format including also a placemarker with the format. The machine field name should end on "_day".

			== Implementation Status - March 23th 2026) ==

	Entities implemented:		Entities implemented:
Line 542:		Line 541:
	* Organisation		* Organisation
	* Asset (basic structure)		* Asset (basic structure)
			* Person
			* Object


	All entities include:		All entities include:
Line 547:		Line 549:
	* edit workflow via dashboard		* edit workflow via dashboard
	* recursive relationships where required		* recursive relationships where required
	* FK implemented ~~where required~~		* FK implemented
	* entity references verified		* entity references verified

	~~Automation for DigitalAsset identifiers is not yet implemented.~~

	== End of Blueprint ==		== End of Blueprint ==
Line 762:		Line 762:
	Organisation string [ref: > Organisation.Code]		Organisation string [ref: > Organisation.Code]
	}		}
			</pre>

			= Appendix - 2: Modules already enabled in our Drupal 11 configuration - version 20260319 ==


	~~</pre>~~

	= Appendix - 2~~: Lessons learned on feb 27 2026 =~~

	~~This session ended in with Drupal in an undetermined stated due to a misunderstanding about the requirements, and then finally a problem wrongly using a Drupal reserved word DASHBOARD.~~

	~~Restart from scratch after that day, restoring of the full virtual disks for both machines dated 26 feb.~~

	~~Conclusion of the day were chatgpt promises for restarting.~~

	~~Tomorrow I will:~~

	* avoid cleverness
	* avoid custom routing early
	* avoid reserved names
	* rely on Drupal defaults first
	* reduce bash steps to the minimum stop earlier when entropy appears

	~~Agreement: You bring architectural clarity. I bring Drupal-specific caution. That’s a workable division.~~

	~~== Important AI protocal ==~~
	After the agreement an a workflow, we work step by step, no hurry. AI proposes a step, I execute and report back the result and then only we go for the next step. Too much explanation is NOT needed, as I am a novice in this field. After 50+ years in ICT, I understand mostly what the steps do and if not, I will ask for. This should permit for a slow but steady flow towards the endgoal of the session.

	~~= Appendix - 4~~: Modules already enabled in our Drupal 11 configuration - version 20260319 ==

	<pre>		<pre>

Mngr at 10:25, 23 March 2026

2026-03-23T10:25:23Z

← Older revision		Revision as of 10:25, 23 March 2026
Line 15:		Line 15:
	== Project Overview ==		== Project Overview ==

	The Costasano Heritage Project is a long-term digital heritage initiative operated by members of the Costa Sano Club (70+ years old, amateur historians, non-ICT specialists).		The Costasano Heritage Project is a long-term digital heritage initiative operated by members of the Costa Sano Club (70+ years old, amateur historians, non-ICT specialists, except for Martin, realising the IT-project, also amateur historian).

	The project manages:		The project manages:
Line 30:		Line 30:
	=== Authoritative Source Principle ===		=== Authoritative Source Principle ===
	There is exactly ONE authoritative system for data and assets:		There is exactly ONE authoritative system for data and assets:
	* '''Drupal 11'''		* '''Drupal 11.3'''

	All other outputs (MediaWiki, public website, video, exhibitions) are derivatives.		All other outputs (MediaWiki, public website, video, exhibitions) are derivatives.
Line 93:		Line 93:
	* PHP-FPM: Per-site pools		* PHP-FPM: Per-site pools
	* Filesystem: Hardened		* Filesystem: Hardened


	=== Operational Constants ===		=== Operational Constants ===

Mngr at 10:21, 23 March 2026

2026-03-23T10:21:40Z

Show changes

Mngr at 10:17, 23 March 2026

2026-03-23T10:17:14Z

Mngr: Mngr moved page ICT:Drupal Blueprint - Version 6.0 to ICT:Drupal Blueprint - Version 6.5 without leaving a redirect

2026-03-23T10:12:04Z

Mngr moved page ICT:Drupal Blueprint - Version 6.0 to ICT:Drupal Blueprint - Version 6.5 without leaving a redirect

← Older revision	Revision as of 10:12, 23 March 2026
(No difference)

Mngr at 10:11, 23 March 2026

2026-03-23T10:11:13Z

← Older revision		Revision as of 10:11, 23 March 2026
Line 1:		Line 1:
	= Costasano Heritage Project — Drupal 11 Architecture & Workflow Blueprint (v6.0) =		= Costasano Heritage Project — Drupal 11 Architecture & Workflow Blueprint (v6.5) =

	== Purpose of this Document ==		== Purpose of this Document ==
Line 273:		Line 273:
	Purpose: Persons model historical agency, responsibility, and participation.		Purpose: Persons model historical agency, responsibility, and participation.

	Implementation ~~Challenges~~: ~~ToDo~~		Implementation:
	~~# choice~~ of PK for ~~Person~~		- automatic numbering of Person entities realized with custom module: PE-00123
	~~# realisation~~ of ~~content type and~~ view		- use for plain text for birthday and deathday due to drupal limitation in Date & Time widget
			- use of custom module to verify the day format DD/MM/YYYY
			- both modules are implemented in heritage-tweaks
			- first view operational
			ToDo: Nihil for time being

	=== Step 6: HeritageObject implementation ===		=== Step 6: HeritageObject implementation ===
Line 315:		Line 319:
	Purpose: HeritageObjects are the primary conceptual anchors of the research.		Purpose: HeritageObjects are the primary conceptual anchors of the research.

	~~Challenges~~: ~~ToDo~~		Implementation:
	- ~~choice~~ of ~~PK? Yes or now different from Object Title including~~		- automatic numbering of object entity: OB-00123
			- Onject is recursive

			ToDO
	- implementation of a many to many relationship between Object and Asset		- implementation of a many to many relationship between Object and Asset
	~~- Objects can be structures (recursiveness)~~		- One digital Asset is a prefered Asset only for illustration purposes of the Object in a view
	- One digital Asset is a prefered Asset ~~and should link to that Aasset and~~ the ~~children of that Asset~~		- Notion of top" Asset in the asset structure is the Asset without parent to by used in the many-to-many relationship. This top asset gives also access to the full tree of assets linked to that top. That top may change in the lifetime of the asset-tree (decided by the user).
	- ~~We opt to chose the "~~top" Asset in the asset structure ~~as orefered Asset (~~the Asset without parent)

	=== Step 7: Object & Advanced Relationships ===		=== Step 7: Object & Advanced Relationships ===

Mngr at 14:29, 19 March 2026

2026-03-19T14:29:43Z

← Older revision		Revision as of 14:29, 19 March 2026
Line 696:		Line 696:
	After the agreement an a workflow, we work step by step, no hurry. AI proposes a step, I execute and report back the result and then only we go for the next step. Too much explanation is NOT needed, as I am a novice in this field. After 50+ years in ICT, I understand mostly what the steps do and if not, I will ask for. This should permit for a slow but steady flow towards the endgoal of the session.		After the agreement an a workflow, we work step by step, no hurry. AI proposes a step, I execute and report back the result and then only we go for the next step. Too much explanation is NOT needed, as I am a novice in this field. After 50+ years in ICT, I understand mostly what the steps do and if not, I will ask for. This should permit for a slow but steady flow towards the endgoal of the session.

	= Appendix - 4: Modules already enabled in our Drupal 11 configuration ==		= Appendix - 4: Modules already enabled in our Drupal 11 configuration - version 20260319 ==

	<pre>		<pre>

Mngr at 14:28, 19 March 2026

2026-03-19T14:28:17Z

Show changes

Mngr at 14:23, 19 March 2026

2026-03-19T14:23:01Z

← Older revision		Revision as of 14:23, 19 March 2026
Line 236:		Line 236:
	View enhanced with search filter.		View enhanced with search filter.
	ToDo: complete help functions		ToDo: complete help functions
			Remark: Inital configuration with Code as PK (Drupal Title) has been abandoned.
			Now Code is a classic field and the Title field is a Caption field. This is a short description of the file.

	== Next Major step: HeritageObject and Person ==		== Next Major step: HeritageObject and Person ==

← Older revision		Revision as of 10:17, 23 March 2026
Line 706:		Line 706:
	<pre>		<pre>
	mngr@localhost:/var/www/drupal$ drush pm:list --status=enabled		mngr@localhost:/var/www/drupal$ drush pm:list --status=enabled
	---------------- ----------------------------------------------------------------------- --------- ----------		---------------- ----------------------------------------------------------------------- --------- ----------
	Package Name Status Version		Package Name Status Version
	---------------- ----------------------------------------------------------------------- --------- ----------		---------------- ----------------------------------------------------------------------- --------- ----------
Line 794:		Line 794:
	Paragraphs Paragraphs Type Permissions (paragraphs_type_permissions) Enabled 8.x-1.20		Paragraphs Paragraphs Type Permissions (paragraphs_type_permissions) Enabled 8.x-1.20
	Paragraphs Paragraphs (paragraphs) Enabled 8.x-1.20		Paragraphs Paragraphs (paragraphs) Enabled 8.x-1.20
	Paragraphs Paragraph Bundle 3D Carousel (paragraph_bundle_3d_carousel) Enabled 1.0.15		Paragraphs Paragraph Bundle 3D Carousel (paragraph_bundle_3d_carousel) Enabled 1.0.16
	Paragraphs Paragraph Bundle 3D Flip Box (paragraph_bundle_3d_flip_box) Enabled 1.0.15		Paragraphs Paragraph Bundle 3D Flip Box (paragraph_bundle_3d_flip_box) Enabled 1.0.16
	Paragraphs Paragraph Bundle Accordion (paragraph_bundle_accordion) Enabled 1.0.15		Paragraphs Paragraph Bundle Accordion (paragraph_bundle_accordion) Enabled 1.0.16
	Paragraphs Paragraph Bundle Alert (paragraph_bundle_alert) Enabled 1.0.15		Paragraphs Paragraph Bundle Alert (paragraph_bundle_alert) Enabled 1.0.16
	Paragraphs Paragraph Bundle Block (paragraph_bundle_block) Enabled 1.0.15		Paragraphs Paragraph Bundle Block (paragraph_bundle_block) Enabled 1.0.16
	Paragraphs Paragraph Bundle Block Content (paragraph_bundle_block_content) Enabled 1.0.15		Paragraphs Paragraph Bundle Block Content (paragraph_bundle_block_content) Enabled 1.0.16
	Paragraphs Paragraph Bundle Card (paragraph_bundle_card) Enabled 1.0.15		Paragraphs Paragraph Bundle Card (paragraph_bundle_card) Enabled 1.0.16
	Paragraphs Paragraph Bundle Carousel (paragraph_bundle_carousel) Enabled 1.0.15		Paragraphs Paragraph Bundle Carousel (paragraph_bundle_carousel) Enabled 1.0.16
	Paragraphs Paragraph Bundle Contact Form (paragraph_bundle_contact_form) Enabled 1.0.15		Paragraphs Paragraph Bundle Contact Form (paragraph_bundle_contact_form) Enabled 1.0.16
	Paragraphs Paragraph Bundle Content (paragraph_bundle_content) Enabled 1.0.15		Paragraphs Paragraph Bundle Content (paragraph_bundle_content) Enabled 1.0.16
	Paragraphs Paragraph Bundle Grid (paragraph_bundle_grid) Enabled 1.0.15		Paragraphs Paragraph Bundle Grid (paragraph_bundle_grid) Enabled 1.0.16
	Paragraphs Paragraph Bundle Hero (paragraph_bundle_hero) Enabled 1.0.15		Paragraphs Paragraph Bundle Hero (paragraph_bundle_hero) Enabled 1.0.16
	Paragraphs Paragraph Bundle Icon (paragraph_bundle_icon) Enabled 1.0.15		Paragraphs Paragraph Bundle Icon (paragraph_bundle_icon) Enabled 1.0.16
	Paragraphs Paragraph Bundle Image (paragraph_bundle_image) Enabled 1.0.15		Paragraphs Paragraph Bundle Image (paragraph_bundle_image) Enabled 1.0.16
	Paragraphs Paragraph Bundle Image Background (paragraph_bundle_image_background) Enabled 1.0.15		Paragraphs Paragraph Bundle Image Background (paragraph_bundle_image_background) Enabled 1.0.16
	Paragraphs Paragraph Bundle Image Grid (Image Gallery - Lightbox) Enabled 1.0.15		Paragraphs Paragraph Bundle Image Grid (Image Gallery - Lightbox) Enabled 1.0.16
	(paragraph_bundle_image_grid)		(paragraph_bundle_image_grid)
	Paragraphs Paragraph Bundle Image Overlay (paragraph_bundle_image_overlay) Enabled 1.0.15		Paragraphs Paragraph Bundle Image Overlay (paragraph_bundle_image_overlay) Enabled 1.0.16
	Paragraphs Paragraph Bundle Layout (paragraph_bundle_layout) Enabled 1.0.15		Paragraphs Paragraph Bundle Layout (paragraph_bundle_layout) Enabled 1.0.16
	Paragraphs Paragraph Bundle Modal (paragraph_bundle_modal) Enabled 1.0.15		Paragraphs Paragraph Bundle Modal (paragraph_bundle_modal) Enabled 1.0.16
	Paragraphs Paragraph Bundle Node Reference (paragraph_bundle_node_reference) Enabled 1.0.15		Paragraphs Paragraph Bundle Node Reference (paragraph_bundle_node_reference) Enabled 1.0.16
	Paragraphs Paragraph Bundle Parallax (paragraph_bundle_parallax) Enabled 1.0.15		Paragraphs Paragraph Bundle Parallax (paragraph_bundle_parallax) Enabled 1.0.16
	Paragraphs Paragraph Bundle Slideshow (paragraph_bundle_slideshow) Enabled 1.0.15		Paragraphs Paragraph Bundle Slideshow (paragraph_bundle_slideshow) Enabled 1.0.16
	Paragraphs Paragraph Bundle Tabs (paragraph_bundle_tabs) Enabled 1.0.15		Paragraphs Paragraph Bundle Tabs (paragraph_bundle_tabs) Enabled 1.0.16
	Paragraphs Paragraphs Bundles (paragraphs_bundles) Enabled 1.0.15		Paragraphs Paragraphs Bundles (paragraphs_bundles) Enabled 1.0.16
	Mail SMTP Authentication Support (smtp) Enabled 8.x-1.4		Mail SMTP Authentication Support (smtp) Enabled 8.x-1.4
	Solo Suite Solo Utilities (solo_utilities) Enabled 1.0.6		Solo Suite Solo Utilities (solo_utilities) Enabled 1.0.6
Line 825:		Line 825:
	Media SVG image (svg_image) Enabled 3.2.2		Media SVG image (svg_image) Enabled 3.2.2
	Costasano Costasano Asset (costasano_asset) Enabled		Costasano Costasano Asset (costasano_asset) Enabled
	~~Custom Historian UI: File Preview~~ (~~historian_ui~~) Enabled		Heritage Heritage Codes (heritage_codes) Enabled 1.0.0
	~~Custom Historians Media Flow~~ (~~historians_media_flow~~) Enabled		Heritage Heritage Tweaks (heritage_tweaks) Enabled
	Core Claro (claro) Enabled 11.3.5		Core Claro (claro) Enabled 11.3.5
	Core Olivero (olivero) Enabled 11.3.5		Core Olivero (olivero) Enabled 11.3.5
	Gin (gin) Enabled 5.0.12		Gin (gin) Enabled 5.0.12
	Solo Solo (solo) Enabled 1.0.30		Solo Solo (solo) Enabled 1.0.31
	---------------- ----------------------------------------------------------------------- --------- ----------		---------------- ----------------------------------------------------------------------- --------- ----------
	</pre>		</pre>