chairemobilite / evolution

Online survey platform for travel survey
MIT License
4 stars 9 forks source link

Renaming proposition #745

Open kaligrafy opened 1 month ago

kaligrafy commented 1 month ago

Proposition for renaming classes, attributes and actions, plus users categories:

Naming conventions

Interview manipulation by use case:

Users:

Please discuss if you agree, and if not, propose better (If you don't like a name, propose a better one :-) )

samuel-duhaime commented 1 month ago

For the admin user, do we want to put some role, because right now admin is too broad of a type ?

tahini commented 1 month ago

For the admin user, do we want to put some role, because right now admin is too broad of a type ?

Yes we do, eventually, none of us should be admin, but we should all have permissions of some kind. We have all the framework for this and we have interviewer/validator roles, but we stopped there as it was enough at the time and didn't get time to work on it...

tahini commented 1 month ago

Sounds good for the renaming. But is that exhaustive enough? What about the case of somebody visualizing the audits (in the summary page) and just setting the interview as valid/invalid, complete/incomplete, questionable? This process does not require correction and we may not want all users who can do that to actually have the permission to correct the interview?

You think of OD surveys, but there are many others where we may just want to manually [in]validate them without giving right to edit.

kaligrafy commented 1 month ago

I think we can still do better renaming and separating users/permissions

tahini commented 1 month ago

Roles/permissions and renaming are 2 separate things anyway.

kaligrafy commented 3 weeks ago

New proposition:

Evolution Platform Nomenclature

Process Names

Interview Process

  1. interview Base process for all interview types

    a. respondentInterview

    • Process where a respondent completes their own interview
    • Real-time data collection from the respondent
    • Can be incomplete

    b. assistedInterview

    • Interview conducted by an interviewer (phone/chat/in-person)
    • Can be starting fresh or continuing a respondentInterview
  2. realTimeValidation

    • Frontend/backend validation during interview
    • Data type checking
    • Response coherence verification
    • Applies to both interview types and to correction process (see below)

Post-Interview Processing

  1. audit (process) & auditReport (group of results) & auditResult (single result) & auditCheck (single validation/check)

    • Automated backend process analyzing completed interviews
    • Generates auditResult instances (error, warning or info)
  2. review (manual)

    • Evaluation of audit reports
    • Decision-making process on interview validity
    • Determination if corrections are needed
    • Interview acceptance or rejection
  3. correction (manual)

    • Modification of interview data
    • Direct editing of interview responses
    • Data cleaning and improvement
  4. enhancement (automated)

    • Enhancement of interview data
    • Data improvement and quality enhancement

Monitoring and export

  1. monitoring
    • Survey monitoring with widgets (plots of started/completed interviews by different variable)
    • Interviewers performance monitoring
  2. export
    • Data extraction of interviews with original responses (non reviewed/non corrected)
    • Data extraction of reviewed//corrected interviews

Role Names

  1. respondent

    • Individual providing interview responses
    • Primary data source
    • Self-guided interview participant
  2. interviewer

    • Phone, chat or in-person support personnel
    • Guides respondents through interview process
    • Real-time data collection specialist
  3. auditor (system role)

    • Automated system process
    • Performs systematic checks
    • Generates audit reports
  4. reviewer

    • Evaluates audit reports
    • Makes decisions on interview validity
    • Determines necessary actions, like corrections needed
  5. corrector

    • Implements required corrections
    • Adjusts geographic data
    • Modifies interview responses
  6. admin

    • Monitoring
    • Manages data exports
    • System administration
    • (To be replaced by specific permissions)

Role-Process Relationships

interview
    ├── respondentInterview (respondent)
    │   └── realTimeValidation
    └── assistedInterview (interviewer)
        └── realTimeValidation

system-auditor
    └── audit
        └── auditReport

reviewer
    └── review

corrector
    └── correction
        └── realTimeValidation

admin
    └── monitoring
    └── export

Notes

kaligrafy commented 3 weeks ago

@tahini Waiting for our review :-)