add: architecture documentation (closes #152) Clarify architecture to ease troubleshooting. See merge request !21