Iridescent-CM / technovation-app

The team submission platform for the Technovation Challenge
https://technovationchallenge.org
GNU General Public License v3.0
7 stars 4 forks source link

Epic: data model documentation #2555

Open hellafitz opened 4 years ago

hellafitz commented 4 years ago

Draft visual documentation of our current data model.

Resources/references from Gunner: "the first and third are likely most germane, second one is a bit arcane:

Data Flow diagram tutorial (detailed with examples) https://www.visual-paradigm.com/tutorials/data-flow-diagram-dfd.jsp There's a lot of content on youtube as well.

Tidy data Wickham, Hadley (20 February 2013). "Tidy Data" (PDF). Journal of Statistical Software. http://vita.had.co.nz/papers/tidy-data.html and a bit more accessibly: https://cfss.uchicago.edu/notes/tidy-data/

Worth scanning the wikipedia article for some nomenclature https://en.wikipedia.org/wiki/Data_model

hellafitz commented 4 years ago

data collection points (rough draft): login | account creation /registration | pre-survey | curriculum activity [Google Analytics activity tracking] | submission | post-survey

Judging: scoring --> score data Educators: voluntary impact survey

TF specific: DCs Lessons UGC (user generated content): Uploads, comments, photos, videos

hellafitz commented 4 years ago

Team questions:

stenington commented 4 years ago

Having slept on it, here's a first stab at something: https://projects.invisionapp.com/freehand/document/cAOchKI28

It takes the sites/platforms map as a starting point and tries to decorate it with info on who logs in where, and what kind of data gets stored in what database or 3rd party service.

stenington commented 4 years ago

@hellafitz The invision board above is my straw man proposal for data model documentation. I don't expect it does what you want it to do, but maybe it provides something concrete to start pulling apart.