;; Personal UX database. Goal of this database is to provide funtions and data
;; to generate an org file for ux planning.

(defconst ux:usability:research-questions
  '((web-sites
     "How easily do users understand what is clickable?"
     "How easily and successfully do users find the products or information they are looking for?"
     "How easily and successfully do users register for the site?"
     "Where in the site do users go to find Search? Why?"
     "How easily can users return to the home page?")
    (small-interfaces
     "How easily do users switch between modes on multi-purpose buttons?"
     "How well do users understand the symbols and icons?"
     "Which ones are problematic? Why?"
     "How easily do users download updates and features?"
     "How quickly can users perform common tasks?")
    (hardware
     "How easily and successfully can users use all buttons on the control panel?"
     "Can users use the control panel without assistance or training?"
     "How easily can users find the correct input and output ports?"
     "How easily can users change settings in the menus?")
    (documentation
     "Do users go to online help when they encounter error messages?"
     "How easily do users find topics they are looking for in the online help?"
     "How well do the topic titles reflect what user are looking for?"
     "How well do they understand the content of the topics they find?"
     "How helpful is the topic content?"
     "Which parts of each topic do users pay attention to?"
     "Can users easily switch between reading the online help and interacting with the interface to complete the task?")
    (software
     "How closely does the flow of the software reflect how the user thinks of the work flow? "
     "How easily and successfully do users find the tools or options they want?"
     "Do users use the toolbar icons or the standard menus? Why?"
     "Is the response time a cause of user frustration or errors?")
    (general
     "What obstacles prevent users from completing installation and set up?"
     "Can users perform common tasks within established benchmarks?"
     "What are the major usability flaws that prevent users from completing the most common tasks?"
     "How does ease-of-use compare in the planned release to the last release?"
     "How does ease-of-use compare between our product and the competition?"
     "Is there an appropriate balance of ease of use and ease of learning?")))

(defconst ux:usability:test-plan-categories
  '("Purpose, goals, and objectives of the test"
    "Research questions"
    "Participant characteristics"
    "Method (test design)"
    "Task list"
    "Test environment, equipment, and logistics"
    "Test moderator role"
    "Data to be collected and evaluation measures"
    "Report contents and presentation"))

(defconst ux:usability:heuristics
  '("Visibility of system status"
    "Match between system and the real world"
    "User control and freedom"
    "Consistency and standards"
    "Error prevention"
    "Recognition rather than recall"
    "Flexibility and efficiency of use"
    "Aesthetic and minimalist design"
    "Help users recognize, diagnose, and recover from errors"
    "Help and documentation")
  "https://www.nngroup.com/articles/ten-usability-heuristics/")

(defconst ux:want-to-learn?
  '((customer
     ("Their goals in purchasing the product.")
     ("Their frustrations with current solutions.")
     ("Their decision process for purchasing a product of the type you’re designing.")
     ("Their role in installing, maintaining, and managing the product.")
     ("Domain-related issues and vocabulary."))
    (user
     ("The context of how the product (or analogous system, if no current product exists) fits into their lives or work flow: when, why, and how the product is or will be used.")
     ("Domain knowledge from a user perspective: What do users need to know to do their jobs?")
     ("Current tasks and activities: both those the current product is required to accomplish and those it doesn’t support.")
     ("Goals and motivations for using their product.")
     ("Mental model: how users think about their jobs and activities, as well as what expectations users have about the product.")
     ("Problems and frustrations with current products (or an analogous system if no current product exists).")))
  "What do we want to learn from users or/and customers?")

(defconst ux:websites
  '("https://usability.yale.edu/"
    "https://webaim.org/"
    "https://digital.gov/"
    "https://www.nngroup.com/articles/"
    "https://www.interaction-design.org/")
  "Important websites for UX topics.")

(defconst  ux:explain-codes
  '((activity "the quality or state of being active. behavior or actions of a particular kind physical activity")
    (job "a piece of work. something that has to be done (task)")
    (objective "something toward which effort is directed")
    (gain "something wanted or desirable")
    (pain "mental or emotional distress or suffering")
    (goal "An expectation of an end condition"))
  "Explain codes used for thematic analysis.")

(defconst ux:map-codes-to-questions
  '((activity . how)
    (job . what)
    (objective . why)
    (gain . why)
    (pain . what)))

(defconst ux:interview-questions
  '((general
     (en "What does your typical weekday look like?")
     (de "Wie sieht Ihr typischer Arbeitstag aus?")
     (en "Tell me about your role at your company?")
     (de "Erzählen Sie mir etwas über Ihre Rolle in Ihrem Unternehmen?")
     (en "Can you give me an overview of your work?")
     (de "Können Sie mir einen Überblick über Ihre Arbeit geben?")
     (fr "Pouvez-vous me donner un aperçu de votre travail (exemple: activités quotidiennes) ?")
     (it "Può darmi un visione generale del suo lavoro? (per exempio: attività giornaliere)"))
    (activities
     (en "What are your most important activities?")
     (de "Was sind Ihre wichtigsten Aktivitäten?")
     (fr "Quelles sont vos principales (importantes) activités ?")
     (it "Quali sono le sue attività più importanti?")
     (en "What activities waste your time?")
     (de "Welche Aktivitäten verschwenden Ihre Zeit?")
     (fr "Quelles sont les activités qui vous font perdre votre temps ou ?")
     (it "Quali sono le attività che ti fanno sprecare tempo?"))
    (job/pain
     (en "What’s the hardest part about [problem / task]?")
     (de "Was ist das Schwierigste an [Problem / Aufgabe]?")
     (en "How do you currently go about [problem / task]?")
     (de "Wie gehen Sie derzeit [Problem / Aufgabe] an?")
     (en "What is the biggest pain point related to [problem / task]?")
     (de "Was ist der größte Schmerzpunkt im Zusammenhang mit [Problem / Aufgabe]?"))
    (demographic
     (en "What is the highest degree or level of education you have completed?")
     (de "Welches ist der höchste Abschluss, den Sie erworben haben?")
     (en "What kind of training did you receive?")
     (de "Welche Art von Ausbildung haben Sie erhalten?")
     (fr "Quel type de formation avez-vous suivi ?")
     (it "Che tipo di educazione ha ricevuto?"))
    (environment
     (en "Where do you do your work (Physical location)?")
     (de "Wo üben Sie Ihre Tätigkeit aus (physischer Standort)?")
     (fr "Où travaillez-vous (lieu physique) ?")
     (it "Dove lavorate (luogo fisico)?"))
    (standard
     (en "What information do you collect?")
     (de "Welche Informationen sammeln Sie?")
     (fr "Quelles informations collecter-vous ?")
     (it "Quali informazioni raccoglie?")
     (en "What information do you need to make a decision?")
     (de "Welche Informationen benötigen Sie, um eine Entscheidung zu treffen?")
     (fr "De quelles informations avez-vous besoin pour prendre une décision ?")
     (it "Di quali informazioni hai bisogno per prendere una decisione?")
     (en "Who do you provide information to?")
     (de "Wem stellen Sie Informationen zur Verfügung?")
     (fr "À qui fournissez-vous des informations ?")
     (it "A chi fornisce informazioni?")
     (en "What device do you use?")
     (de "Welches Gerät benutzen Sie?")
     (fr "Quel appareil utilisez-vous ?")
     (it "Quale dispositivo usa?")
     (en "How do you keep track of what you need to get done at work?")
     (de "Wie behalten Sie den Überblick darüber, was Sie bei der Arbeit zu erledigen haben?")
     (fr "Comment gardez-vous une trace de ce que vous avez à faire au travail")
     (it "Come fa a tenere traccia di quello, che deve fare al lavoro?"))
    (sus
     (en "I think that I would like to use this system frequently.")
     (de "Ich denke, dass ich dieses System häufig nutzen möchte.")
     (en "I found the system unnecessarily complex.")
     (de "Ich fand das System unnötig komplex.")
     (en "I thought the system was easy to use.")
     (de "Ich fand das System einfach zu bedienen.")
     (en "I think that I would need the support of a technical person to be able to use this system.")
     (de "Ich glaube, ich bräuchte die Unterstützung einer technischen Person, um dieses System nutzen zu können.")
     (en "I found the various functions in this system were well integrated.")
     (de "Ich fand, dass die verschiedenen Funktionen in diesem System gut integriert waren.")
     (en "I thought there was too much inconsistency in this system.")
     (de "Ich fand, dass dieses System zu widersprüchlich war.")
     (en "I would imagine that most people would learn to use this system very quickly.")
     (de "Ich könnte mir vorstellen, dass die meisten Menschen sehr schnell lernen würden, mit diesem System umzugehen.")
     (en "I found the system very cumbersome to use.")
     (de "Ich fand das System sehr umständlich zu bedienen.")
     (en "I felt very confident using the system.")
     (de "Ich fühlte mich sehr sicher im Umgang mit dem System.")
     (en "I needed to learn a lot of things before I could get going with this system.")
     (de "Ich musste eine Menge Dinge lernen, bevor ich mit diesem System loslegen konnte."))))

(defun ux:questions-by-category (category)
  (cdr (assoc category ux:interview-questions)))

(defun ux:questions-by-lang (lang category)
  (let* ((questions (ux:questions-by-category category))
         (lang-questions (remove nil (mapcar #'(lambda (x) (member lang x)) questions))))
    (remove lang (flatten-tree lang-questions))))