ToC to schema doc, proposed workflow in the workflow spec

Specifications/Schema SQL.md

@@ -8,23 +8,22 @@ There is an interactive schema web site: [Schema web site](http://shannonvm.vill
 
 ### Table of contents
 
-[Multiple names, alternate names, components](#multiple-names-alternate-names-components)
-
-[How dates are stored](#how-dates-are-stored)
-
-[How versioning works](#how-versioning-works)
-
-[Foreign key related records](#foreign-key-related-records)
-
-[Vocabulary table history and rationale](#vocabulary-table-history-and-rationale)
-
-[Vocabulary separate SQL file](#vocabulary-separate-sql-file)
-
-[Common fields and their meaning](#common-fields-and-their-meaning)
-
-[Identical text tables](#identical-text-tables)
-
-[Geographic authority](#geographic-authority)
+* [Constellations that are SNAC institutions](#constellations-that-are-snac-institutions)
+* [Multiple names, alternate names, components](#multiple-names-alternate-names-components)
+* [How dates are stored](#how-dates-are-stored)
+* [How versioning works](#how-versioning-works)
+* [Foreign key related records](#foreign-key-related-records)
+* [Vocabulary table history and rationale](#vocabulary-table-history-and-rationale)
+* [Vocabulary separate SQL file](#vocabulary-separate-sql-file)
+* [Common fields and their meaning](#common-fields-and-their-meaning)
+* [Identical text tables](#identical-text-tables)
+* [Geographic authority](#geographic-authority)
+
+
+### Constellations that are SNAC institutions
+
+We need to add a new table snac_institutions which is a linking table identifying which constellations are
+SNAC institutions. This is used by the user admin code to show/search institutional affiliation.
 
 
 ### Multiple names, alternate names, components

Specifications/Workflow Engine.md

@@ -132,6 +132,53 @@ several states, and will require relevant tests.
 | done  |                               | exit                  |            |
 
 
+### Possible server workflow
+
+This is a slight expansion of the current server workflow. This moves authentication from a hard-coded
+function into the WFE. Next we add a new function that updates this users notifications by calling into the
+yet-to-be-created notification system. It ping pending tasks, and updates notices that show up on the
+dashboard. Having gotting these initial tasks out of the way, commands can be processed.
+
+This shows a more detailed view of publishing. Anyone watching this SNAC record gets an update. We also
+notifiy the manager of this user. Finally we publish.
+
+Unlocking also has more detailed steps. Start by unlocking, and immediately re-locking to the reviewer. Notify
+the reviewer, and update notifications for the user. 
+
+
+| state         | test                          | worker                | next-state    |
+|---------------+-------------------------------+-----------------------+---------------|
+| start         | confirm-authentication        |                       | init          |
+| start         |                               | authentication-error  | done          |
+| init          |                               | update-notification   | docmd         |
+|               |                               |                       |               |
+| docmd         | command-vocabulary            | search-vocabulary     | done          |
+| docmd         | command-reconcile             | reconcile             | done          |
+| docmd         | command-start-session         | start-session         | done          |
+| docmd         | command-end-session           | end-session           | done          |
+| docmd         | command-user-info             | user-info             | done          |
+| docmd         | command-insert-constellation  | insert-constellation  | done          |
+| docmd         | command-update-constellation  | update-constellation  | done          |
+| docmd         | command-unlock-constellation  |                       | unlock-tasks  |
+| docmd         | command-publish-constellation |                       | publish-tasks |
+| docmd         | command-recently-published    | recently-published    | done          |
+| docmd         | command-read                  | read-constellation    | done          |
+| docmd         | command-edit                  | edit-constellation    | done          |
+| docmd         |                               | unknown-command       | done          |
+|               |                               |                       |               |
+| publish-tasks |                               | notify-watchers       | pt2           |
+| pt2           |                               | notify-manager        | pt3           |
+| pt3           |                               | publish-constellation | done          |
+|               |                               |                       |               |
+| unlock-tasks  |                               | unlock-constellation  | unlock2       |
+| unlock2       |                               | lock-to-reviewer      | unlock3       |
+| unlock3       |                               | notify-reviewer       | unlock4       |
+| unlock4       |                               | update-notification   | done          |
+|               |                               |                       |               |
+| done          |                               | exit                  |               |
+
+
+
 
 ### WebUI workflow