Moderator - JerryNixon/2025-luca-ama-app GitHub Wiki

Moderator

Stories & Acceptance criteria

As a [moderator] I want to [create an event] so that [I can moderate questions]
- Field: name, open date, close date.
- Validation: name is required, max of 100 characters
- Validation: open date is optional
- Validation: close date must be after open date

---
title: Create an event
---
flowchart LR
    id1([Click 'New'])
    subgraph workflow [ ]
        id3[Edit]
        id4{Valid?}
    end
    subgraph moderation [ ]
        id6a[(Save)]
        id5[Auto-add<br/>Moderator]
    end
    id6([End])

    id1 --> id3
    id3 -- Save --> id4
    id4 -- Yes --> id6a
    id6a --> id5
    id5 --> id6
    id4 -- No --> id3
    id3 -- Cancel --> id6

As a [moderator] I want to [grant access to the event] so that [the right participants can join the AMA]
- I can generate a link that people can use to join the AMA
- I am automatically added to the event

---
title: Generate Share Link
---
flowchart LR
    A([Open 'Generate'])
    subgraph stepgroup [ ]
      C[Generate]
      D[Copy to<br/>Clipboard]
    end
    E([Done])

    A --> C
    C --> D
    D --> E

As a [moderator] I want to [edit an event] so that [I can update event details if plans change]
- I can edit: name, open date, close date.
- Validation: name is required, max of 100 characters
- Validation: open date is optional
- Validation: close date must be after open date

---
title: Edit an Event
---
flowchart LR
    A([Click 'Edit'])
    subgraph group1 [ ]
        B[Edit]
        C{Valid?}
    end
    D[(Save)]
    E([End])
    
    A --> B
    B -- Save --> C
    C -- Yes --> D
    D --> E
    C -- No --> B 
    B -- Cancel --> E

As a [moderator] I want to [delete the event] so that [I can remove events that are no longer needed]
- removed from the database
- I am prompted "are you sure?"

---
title: Delete an event
---
flowchart LR
    A([Click 'Delete'])
    subgraph Sure [ ]
        B{"Sure?"}
        D[(Delete)]
    end
    E([End])

    A --> B
    B -- Yes --> D
    D --> E
    B -- No --> E

As a [moderator] I want to [filter questions] so that [I can quickly find relevant or high-priority questions]
- I want to be able to filter by keywords
- I want to be able to filter by author
- I want to be able to sort by votes
- I want to be able to filter by answered

---
title: Filter Question List
---
flowchart LR
    A([Type in 'Filter'])
    subgraph filtering [ ]
    B[Keyword<br/>Author<br/>Answered status]
    C[Apply]
     end
    D([Done])

    A -- Choose --> B
    B --> C
    C --> D

As a [moderator] I want to [mark a question as answered] in the question list so that [It goes to the question answered tabs]
- Question marked answered can be unmarked
- If question is answered I want it to go to a tab while staying in the main one

---
title: Mark Question Answered
---
flowchart LR
    A([Open List])
    B[Click 'Answered']
    C{Staged?}
    subgraph S [ ]
        D[Unstage]
        E[(Update)]
    end
    F([Done])

    A --> B --> C
    C -- Yes --> D
    D --> E
    C -- No --> E
    E --> F

As a [moderator] I want to [add a presenters note to a question] so that [I have context or guidance when answering]
- I want it obvious in the UI
- I want it to only be visible to the [moderator] and the [presenter]
- I want an AI summary of the question

---
title: Presenter Notes
---
 flowchart LR
    A([Question List])
    B[Select Question]
    subgraph Note [ ]
    C[Add Note]
    D[Enter Note Text]
    E[(Save Note)]
    end
    F[Visible Moderator/Presenter Only]
    G([Done])

    A --> B --> C --> D --> E --> F --> G

As a [moderator] I want to [add a star to a question] in the question list so that [I can highlight it as important]
- Star toggle must reflect immediately
- Starred questions appear in the "Stars Only" tab

---
title: Star Question
---
 flowchart LR
    A([Question List])
    B[Select a Question]
    subgraph Star [ ]
    C[Add Star]
    D[Question is Starred]
    E[(Save)]
    end
    F([Done])
    A --> B --> C --> D --> E --> F

As a [moderator] I want to [remove a star from a question] in the question list so that [it is no longer marked as important]
- Star toggle must reflect immediately
- Question is removed from the "Stars Only" tab

---
title: Remove star
---
 flowchart LR
    A([Question List])
    B[Select a Starred Question]
    subgraph removed
    C[Remove Star]
    D[Question is Unstarred]
    E[(Save)]
    end
    F([Done])

    A --> B --> C --> D --> E --> F

As a [moderator] I want to [stage a question] in the question list so that [it appears in the “Now Playing” section]
- Only one question can be staged at a time
- Staged question must appear in the "Now Playing" tab

---
title: Stage Question
---
flowchart LR
    A([Question List])
    B[Select Question]
    subgraph Stage [ ]
    C[Click Stage]
    D[Replace Staged Question]
    end
    E[Appears in Now Playing]
    F([Done])

    A --> B --> C --> D --> E --> F

As a [moderator] I want to [view grouped questions under a parent question] in the question list so that [I can manage them more easily].
- Parent question must display a [+] toggle
- Clicking [+] reveals grouped questions

---
title: Group Questions
---
 flowchart LR
    A([Question List])
    B[Parent Question]
    subgraph Toggle [ ]
    C{Is + Toggle Visible?}
    D[Click +]
    end
    E[Reveal Grouped Questions]
    F([Done])
    

    A --> B --> C
    C -- Yes --> D --> E --> F
    C -- No --> F

Workflows

Login workflow

⚠️ GitHub.com Fallback ⚠️