User Tools

Site Tools


damsym:resource_management

This is an old revision of the document!


Resource Management

General Description

The Add Resource section allows authenticated users to create, edit, and monitor textual resources within the DaMSym system. Each resource represents a unit of content (text, excerpt, or document) that can subsequently be included in the semantic search engine and made publicly available for consultation. The entire management process is regulated by a multi-level approval workflow, which distinctly involves the roles of Researcher, Reviewer, and WP Lead. This model ensures that every new resource is verified and validated before final publication.


Adding New Resources (Add Resource)

Once authenticated, the user sees the “Add Resource” button in the top navigation bar, which provides access to the submission form. From this section, it is possible to upload a new resource by filling in the mandatory and optional fields required for the selected language. (Figures 12–14)

The resource creation process follows these steps:

1. **Language selection** → the user selects one of the available linguistic domains (Arabic, Slavic, Greek, Latin, Sanskrit).
2. **Field completion** → depending on the language, the required metadata fields are displayed (title, author, work, text, description, etc.).
3. **Draft saving** → by clicking **Save draft**, the resource is stored in *Draft* status within the **Contributions** section of the Dashboard.
4. **Submission for approval** → after review, the user can select **Submit** to send the resource to the WP Lead for evaluation.

All mandatory fields must be completed in order to submit a resource; otherwise, the system highlights validation errors.

Figure 9, Create new item Figure 10, Add Resource Figure 11, Add Slavonic resource


Module Structure and Behaviour

The resource creation and editing module is composed of multiple adaptive sections that dynamically update according to the selected language.

Common fields:

  • Title
  • Language
  • Author
  • Text
  • Description
  • Date (not available for the Sanskrit language)

Language-specific fields:

  • Slavic: font selection field (required for correct character rendering)

Add Font:

  • For the Church Slavonic language, the Add Font functionality is available, allowing the integration of new fonts or specific character sets into the display system.
  • This function is accessible to the WP Lead from the Dashboard and ensures correct graphical rendering of texts using special characters.

Available actions within the module:

  • Save draft → saves the resource in Draft status
  • Submit → sends the resource to the WP Lead for approval; this action is available in the Dashboard next to Draft resources, together with the icons:
    • 🗑️ Delete (delete)
    • ✏️ Edit (edit)
    • 👁️ View (view)
  • Cancel → cancels the current changes
  • Delete → permanently deletes the selected resource

During saving, the system performs automatic validation checks to ensure that all required fields are correctly filled in and consistent with the selected language.


Creation and Approval Workflow

Each resource created within DaMSym follows a defined status workflow that regulates interactions between Researcher, Reviewer, and WP Lead.

Status Description Enabled role
Draft Resource saved as a draft. Visible and editable only by the author. Researcher / Reviewer
Waiting for approval Resource submitted to the WP Lead for approval. Researcher / Reviewer
Approved Resource approved and made searchable within the corpus. WP Lead
Rejected Resource rejected by the WP Lead, optionally with an explanatory note. WP Lead

Summary workflow:

Researcher / Reviewer → Add Resource        ↓       Save draft        ↓      Confirm submission        ↓      WP Lead review        ↓ Approve → Published in search Reject → Returns to Draft

This model ensures accurate control and complete traceability of the editorial process.


Dashboard and Contributions

The Dashboard is the personal resource management area for all authenticated users. It can be accessed via the user menu (profile icon in the top-right corner) and consists of a table listing the resources associated with the user or their working group.

The table displays:

  • resource title,
  • language,
  • current status (Draft, Waiting for approval, Approved, Rejected),
  • creation or modification date,
  • available actions (Edit, Confirm, Delete).

Users with the Researcher and Reviewer roles can manage only their own resources, while WP Leads can view the complete list and intervene in approval or rejection processes. (Figure 15)

Figure 12, Approve / Reject


Role of the WP Lead

The WP Lead plays a key supervisory and control role over the entire editorial workflow. In addition to standard creation and editing functions, the WP Lead has the following additional privileges in the Dashboard:

  • approval or rejection of resources submitted by researchers;
  • deletion of non-compliant content;
  • visualization and management of feedback (See Ratings);
  • Rating Export section;
  • Add Font section, with the ability to integrate new characters or graphical variants into the search system.

These functions make the WP Lead the primary authority responsible for the quality and consistency of published content.


Security and Traceability

Every creation, modification, or approval operation is recorded in the system with the following parameters:

  • ID of the user who performed the action;
  • type of operation (create, edit, approve, reject, delete);
  • operation timestamp;
  • optional review notes or justifications.

This ensures a high level of auditability and transparency, in compliance with the security policies of ITSERR and RESILIENCE.


Resource Modifications

The system includes advanced editing tools that allow intervention on already saved resources:

  • Edit Text (Corrections) → for modifications or suggestions on existing texts;
  • Edit Metadata → for updating or correcting descriptive information;
  • Add Metadata → for adding new informational fields, such as alternative titles or additional sources.

All modifications are tracked by the system and submitted for verification by the WP Lead, who can approve or reject the updates. These features make data management dynamic and collaborative, in line with the academic validation principles of the ITSERR project.

damsym/resource_management.1768490900.txt.gz · Last modified: by fincons