Adds requirements and userstories. also updates diagrams to be mermaid diagrams instead of text variants

2026-06-17 11:31:17 +02:00
parent 73025c5a84
commit c7154e288f
13 changed files with 1018 additions and 163 deletions
@@ -0,0 +1,100 @@
+# Personas — CMS Frontend
+
+## Persona 1: Owner
+
+**Role**: Owner (highest privilege)
+
+**Description**: The person who owns and manages the entire CMS platform. Typically the technical lead or product owner of the organisation. Has full access to all parts of the system.
+
+**Goals**:
+- Maintain full control over the platform
+- Manage users and their roles
+- Monitor and update system availability
+- Access all administrative functions
+
+**Characteristics**:
+- Technically proficient
+- Responsible for platform health and security
+- May also act as CMS content manager
+- Only persona with access to System Settings
+
+**Relevant Stories**: US-01 through US-20 (all stories)
+
+---
+
+## Persona 2: Admin
+
+**Role**: Admin
+
+**Description**: A trusted team member who manages day-to-day CMS operations. Can invite and manage users but cannot access system-level settings.
+
+**Goals**:
+- Invite new users to the platform
+- Manage CMS content (future)
+- View and manage the user list
+
+**Characteristics**:
+- Regular platform user with elevated permissions
+- Does not manage system-level configuration
+- Typically assigned by the Owner
+
+**Relevant Stories**: US-01, US-02, US-03, US-04, US-05, US-08, US-09, US-10, US-11, US-12, US-15, US-18, US-19, US-20
+
+---
+
+## Persona 3: User
+
+**Role**: User (standard access)
+
+**Description**: A regular user of the CMS platform. Uses the frontend for content tasks. Cannot manage other users or access administrative settings.
+
+**Goals**:
+- Access the CMS to perform content-related tasks
+- View their own profile
+- Navigate to relevant CMS sections
+
+**Characteristics**:
+- Least privileged authenticated persona
+- Primarily uses Dashboard and CMS Management
+- Cannot invite users or access system settings
+
+**Relevant Stories**: US-01, US-02, US-03, US-04, US-05, US-08, US-09, US-15, US-18, US-19, US-20
+
+---
+
+## Persona 4: New Invited User
+
+**Role**: Unauthenticated (completing account setup)
+
+**Description**: A person who has received an email invitation to join the platform. They have not yet created their account. They access the platform via a unique invitation link.
+
+**Goals**:
+- Complete account setup using their invitation token
+- Set a secure password
+- Gain access to the platform
+
+**Characteristics**:
+- Not yet registered; no credentials
+- Has a limited-time invite token
+- May receive an expired or already-used token
+
+**Relevant Stories**: US-13, US-14
+
+---
+
+## Persona 5: Anonymous Visitor
+
+**Role**: Unauthenticated (no credentials, no invite)
+
+**Description**: An unauthenticated person attempting to access the CMS frontend, or a first-time user visiting the system before it has been initialized.
+
+**Goals**:
+- Reach the login page to authenticate
+- Complete initial system setup (if first-ever visitor and no Owner exists)
+
+**Characteristics**:
+- No credentials or role
+- Should be redirected appropriately (to login or setup)
+- Cannot access any protected resources
+
+**Relevant Stories**: US-04, US-06, US-07