ICT:Workflow - Revision history

192.168.33.222: Serious revision due to latest design decisions

2026-02-09T10:52:31Z

Serious revision due to latest design decisions

← Older revision		Revision as of 10:52, 9 February 2026
Line 1:		Line 1:
	= Operational ~~Workflow~~ =		= Operational Workflows =

	This page describes how data, pages, and media are created, edited, and published.		This page describes how data, pages, and media are created, edited, and published. It focusses on practical day-to-day workflows.

	~~It focuses on practical day-to-day workflows.~~		== Workflow for clubmembers ==

	== ~~General~~ Workflow ~~Principle~~ ==

			=== General Workflow Principle ===
	Work proceeds in phases:		Work proceeds in phases:

Line 16:		Line 15:
	Public output must be stable and curated.		Public output must be stable and curated.

	== ~~Creating Structured Pages~~ ==		=== Public Publication Workflow ===
			Publication is a deliberate act for club members only.

			Typical steps:

			# Identify content ready for publication
			# Create or select a public file derivative in the Research: namespace which is not public
			# Verify that no internal files are referenced
			# Once reviewed and redy for publication, the page is copied to the MAIN: namespace and as such available to the general public
			# A review version of the document remains in Research: namespace.

			=== Research: namespace - prepare publication and home for user guides ===
			The Research: namespace is accessible for all clubmembers and is the host for

			# Documents explaining the workflow procedures in laymans terms
			# The environment for preparing documents for the general public.

			=== Dashboard: namespace - Adding and editing objects workflow ===
			Access and editing objects in the project go through the dashboard. a Dashboard: namespace i intended for this workflow

			# There is an overview Dashboard; page.
			# Each entity in its particular namespace has a dashboard page

	=== ~~Heritage Objects~~ (~~Heritage~~:) ===		=== (Main): namespace ===
			The (Main) namespace is the default one and does not need to be mentioned. All pages without explicit namespace mentioned in front are in the (Main) namespace and PUBLIC.

			# The public namespace has a home page for the website which is the landing page for https://mwiki.costasana.club
			# This public space is reserved for documents created in the Research: namespace and are after review approved by the club members for public publication.
			# If decided by the club membsers, these pages may also be copied to Wikipedia.

			=== Creating Structured Pages describing research objects ===

			==== Heritage Objects (Heritage:) ====
	Steps:		Steps:

	# Use the HeritageObject form		# Use the HeritageObject dashboard to access the form
			# Dashboard acces is Dashboard:Heritage
	# Enter required metadata		# Enter required metadata
	# Select elements for automatic numbering		# Select elements for automatic numbering
	# Save the page		# Save the page
	# Review stored data via the ~~provided~~ dashboard		# Review stored data via the dashboard

	Editing of Heritage: pages goes through the dashboard. Heritage: pages are for internal viewing.		Editing of Heritage: pages goes through the dashboard. Heritage: pages are for internal viewing.
Line 34:		Line 63:
	Steps:		Steps:

	# Create an Asset: page using ~~the~~ Asset~~:Dashboard~~		# Create an Asset: page using Dashboard:Asset
			# ONE Asset goes with ONE media file
	# Select elements for automatic numbering.		# Select elements for automatic numbering.
	# ~~Filenames ares the same as~~ the automatic name for ~~Assets~~.		# Upload a filen. Filename is automatic and is based on the automatic name for the Asset.
	~~# Link files to the DigitalAsset~~
	# Link the Asset to one or more Heritage: pages		# Link the Asset to one or more Heritage: pages
	# Optionally define parent/child relationships between Assets		# Optionally define parent/child relationships between related Assets and its media files

	~~DA pages are internal and not intended for public viewing.~~		=== Other Entities ===
			Steps:

	~~== Managing Relationships ==~~		# Similar as for Heritage Objects and DigitalAssets
			# Access only via a dashboard
			# Dashboards exist for Person, Place, Organizatin, Keywords etc..

			== Workflow for SYSOP ==

			=== Managing Relationships ===
	Many-to-many relationships are handled using:		Many-to-many relationships are handled using:

	* Cargo subtables		* Cargo subtables
	* Repeatable form sections		* Repeatable form sections
			* Only accessible by the sysop

	Examples:		Examples:
Line 56:		Line 92:
	Relationships are always edited in the context of a parent page.		Relationships are always edited in the context of a parent page.

	=~~= File Upload Workflow ==~~		=== Schema Evolution Workflow ===

	~~# Files are uploaded via DigitalAssets pages.~~
	~~# File name and format~~
	~~# Add file reference to a DA page~~
	~~# Do not embed internal files on public pages~~

	~~File uploads are restricted to club members.~~

	~~== Public Publication Workflow ==~~

	~~Publication is a deliberate act.~~

	~~Typical steps:~~

	~~# Identify content ready for publication~~
	~~# Create or select a public file derivative~~
	~~# Embed the public file on a page in the Main namespace~~
	~~# Verify that no internal files are referenced~~

	~~Internal DA pages remain private.~~

	== Schema Evolution Workflow ==

	Changes to structure follow this order:		Changes to structure follow this order:

			# This workflow is reserved to the sysop or administrator
	# Update Cargo table		# Update Cargo table
	# Save Cargo page to activate changes		# Save Cargo page to activate changes
	# Update ~~Page Schema if needed~~		# Update forms, special templates and dashboard if required
	~~# Regenerate~~ forms if required
	# Test with sample data		# Test with sample data

	Never change schema directly in the database.		Never change schema directly in the database.

	== Error Handling ==		=== Error Handling ===

	If data does not appear as expected:		If data does not appear as expected:

Mngr: Adaptation to new situation with dashboard and automatic numbering

2026-02-09T10:05:25Z

Adaptation to new situation with dashboard and automatic numbering

← Older revision		Revision as of 10:05, 9 February 2026
Line 18:		Line 18:
	== Creating Structured Pages ==		== Creating Structured Pages ==

	=== Heritage Objects (HO:) ===		=== Heritage Objects (Heritage:) ===

	Steps:		Steps:
Line 24:		Line 24:
	# Use the HeritageObject form		# Use the HeritageObject form
	# Enter required metadata		# Enter required metadata
			# Select elements for automatic numbering
	# Save the page		# Save the page
	# Review stored data via ~~queries if needed~~		# Review stored data via the provided dashboard

	~~Direct editing~~ of HO pages ~~without forms is discouraged~~.		Editing of Heritage: pages goes through the dashboard. Heritage: pages are for internal viewing.

	=== Digital Assets (DA:) ===		=== Digital Assets (Asset:) ===

	Steps:		Steps:

	~~# Upload file(s) (club members only)~~		# Create an Asset: page using the Asset:Dashboard
	# Create ~~a DA~~ page using the ~~DigitalAsset form~~		# Select elements for automatic numbering.
	# Link files to the DA		# Filenames ares the same as the automatic name for Assets.
	# Link DA to one or more HO pages		# Link files to the DigitalAsset
	# Optionally define parent/child relationships between ~~DAs~~		# Link the Asset to one or more Heritage: pages
			# Optionally define parent/child relationships between Assets

	DA pages are internal and not intended for public viewing.		DA pages are internal and not intended for public viewing.
Line 56:		Line 58:
	== File Upload Workflow ==		== File Upload Workflow ==

	# ~~Upload file to File: namespace~~		# Files are uploaded via DigitalAssets pages.
	# ~~Verify file~~ name and format		# File name and format
	# Add file reference to a DA page		# Add file reference to a DA page
	# Do not embed internal files on public pages		# Do not embed internal files on public pages

Mngr: Mngr moved page ICT:workflow to ICT:Workflow without leaving a redirect

2026-01-17T17:00:23Z

Mngr moved page ICT:workflow to ICT:Workflow without leaving a redirect

← Older revision	Revision as of 17:00, 17 January 2026
(No difference)

Mngr: Created page with "= Operational Workflow = This page describes how data, pages, and media are created, edited, and published. It focuses on practical day-to-day workflows. == General Workflow Principle == Work proceeds in phases: # Internal research and structuring # Review and validation # Public publication Internal work may be complex and incomplete. Public output must be stable and curated. == Creating Structured Pages == === Heritage Objects (HO:) === Steps: # Use the Herit..."

2026-01-17T16:50:37Z

Created page with "= Operational Workflow = This page describes how data, pages, and media are created, edited, and published. It focuses on practical day-to-day workflows. == General Workflow Principle == Work proceeds in phases: # Internal research and structuring # Review and validation # Public publication Internal work may be complex and incomplete. Public output must be stable and curated. == Creating Structured Pages == === Heritage Objects (HO:) === Steps: # Use the Herit..."

New page

= Operational Workflow =

This page describes how data, pages, and media are created, edited, and published.

It focuses on practical day-to-day workflows.

== General Workflow Principle ==

Work proceeds in phases:

# Internal research and structuring
# Review and validation
# Public publication

Internal work may be complex and incomplete.
Public output must be stable and curated.

== Creating Structured Pages ==

=== Heritage Objects (HO:) ===

Steps:

# Use the HeritageObject form
# Enter required metadata
# Save the page
# Review stored data via queries if needed

Direct editing of HO pages without forms is discouraged.

=== Digital Assets (DA:) ===

Steps:

# Upload file(s) (club members only)
# Create a DA page using the DigitalAsset form
# Link files to the DA
# Link DA to one or more HO pages
# Optionally define parent/child relationships between DAs

DA pages are internal and not intended for public viewing.

== Managing Relationships ==

Many-to-many relationships are handled using:

* Cargo subtables
* Repeatable form sections

Examples:
* Object–Person relationships
* Object–Set memberships

Relationships are always edited in the context of a parent page.

== File Upload Workflow ==

# Upload file to File: namespace
# Verify file name and format
# Add file reference to a DA page
# Do not embed internal files on public pages

File uploads are restricted to club members.

== Public Publication Workflow ==

Publication is a deliberate act.

Typical steps:

# Identify content ready for publication
# Create or select a public file derivative
# Embed the public file on a page in the Main namespace
# Verify that no internal files are referenced

Internal DA pages remain private.

== Schema Evolution Workflow ==

Changes to structure follow this order:

# Update Cargo table
# Save Cargo page to activate changes
# Update Page Schema if needed
# Regenerate forms if required
# Test with sample data

Never change schema directly in the database.

== Error Handling ==

If data does not appear as expected:

# Check Cargo table definition
# Check that the Cargo page was saved
# Check form-to-field mapping
# Check namespace and category constraints

== Status ==

This workflow is considered stable but may evolve.