From 63b4835852abcdae300286cbac8d670c26904711 Mon Sep 17 00:00:00 2001 From: simon Date: Fri, 14 Oct 2016 13:19:01 +0100 Subject: [PATCH] Added entity-relationship diagram. --- .../entity-relationship-diagram.svg | 860 ++++++++++++++++++ doc/specification/userspec.md | 31 + 2 files changed, 891 insertions(+) create mode 100644 doc/specification/entity-relationship-diagram.svg diff --git a/doc/specification/entity-relationship-diagram.svg b/doc/specification/entity-relationship-diagram.svg new file mode 100644 index 0000000..6aafafc --- /dev/null +++ b/doc/specification/entity-relationship-diagram.svg @@ -0,0 +1,860 @@ + + + + + + + + + + + + image/svg+xml + + + + + + + + YouYesYet: Entity Relationship Diagram + + District + + Addresss + + Elector + + Canvasser + + Authority + + Visit + + Intention + + IssueExpertise + + Issue + + FollowupRequest + + FollowupAction + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Option + + + + + + + + + + + + + + + + + + Version: 0.1Date: 20161014Author: Simon BrookeCopyright: (c) 2016 Simon Brooke for Radical Independence Campaign + + + + Introduced + Visited + Recorded + Raised + Authenticates + Has + About + About + Responded to + Expressed + Contains + Resides at + Requested + For + Performed + To + + diff --git a/doc/specification/userspec.md b/doc/specification/userspec.md index f7b4f92..9c31b39 100644 --- a/doc/specification/userspec.md +++ b/doc/specification/userspec.md @@ -130,6 +130,25 @@ The *Followup Request* form is a simple form which allows the canvasser to recor | | +------------------------------------------------+ +## How Street Canvassers will use the system + +Street Canvassers will typically use the system by + +1. Arriving in an area, often with a group of other canvassers; +2. Logging into the system; +3. Looking at the map view and choosing an uncanvassed dwelling to canvas; +4. Opening the Electors View for that dwelling; +5. Chapping the door; +6. Asking the person who answers about voting intentions, and recording these be selecting the appropriate option buttons; +7. Addressing any issues the elector raises directly, if possible; +8. If there are more detailed issues the elector wants to address, raising a followup request; +9. Making a polite goodbye; +10. Returning to the map view and choosing the next dwelling to canvas. + +## Telephone canvassing + +We also need a workflow for telephone canvassing, but I have not yet given thought to how that would work. + ## Followup Requests view This view is available only to Issue Experts, and is the first view and Issue Expert sees after aelecting *Issue Expert* from the roles menu. @@ -157,3 +176,15 @@ Below this on the page is a *Wiki section* which contains links to resources whi As specified above, the *Followup Action* view contains a section which functions as a Wiki page. This may incorporate links to further Wiki pages, or to resources out on the wider Internet. Issue Experts are entitled to edit Wiki pages within the system. Note that the *Issue View* in the Canvassers' user interface is a special Wiki page, which can also be edited by the relevant issue experts. + +## Gamification and 'Scores' + +Reading up on Bernie Saunders' campaign's canvassing app, it apparently contained gamification features which were seen as significantly motivational for younger canvassers. Canvassers should be able to see a screen which shows + +1. Total time logged in; +2. Total visits made; +3. Total voting intentions recorded; +4. Number of visits made per hour logged in; +5. Number of voting intentions recorded per hour logged in. + +I'd like a way for local canvassing teams to be able to see one another's scores, so as to encourage friendly competition, but I haven't yet defined a mechanism for how that might be done. I think a national high-score table would probably be a bad thing, because it might encourage people to create fictional records without actually talking to the electors.