Arch notes
==========

Workflow
--------


    [ SugarTrail::Repo ]

       | 1      init(type,args) # init repo:
       |                        # * type can be Filesystem or other,
       |                        # * args can be root, connection string...
       |        load(master)    # obtain Master from repo
       v n

    [ SugarTrail::Template::Master ]

       | 1      parse_head()    # parse text and fill out metadata properties
       |        gen_slave(args) # generate a number of Slaves from a Master
       |                        # * args - args specify ranges from where
       |                        #          Slavess are generated; typically
       |                        #          based on a Cartesian product
       |                        #          (think OS x ARCHS x PROTOCOLS)
       v n

    [ SugarTrail::Template::Slave ] = ::Master + args

       | 1      gen_task(slave)     # a task (or a number of) can be created
       |                            # from Slave.  In less managed scenarios
       |                            # (e.g. Beta testing) Slave can be served
       |                            # right away, and task ID will be generated
       |                            # off-site, e.g. using embedded JS, at
       |                            # time of report
       v n

    [ SugarTrail::Task ] = ::Slave + (taskid)



### More graphical, from HTTP POV ###


*   the main source file is stored in repository, under revision
    say, 123

    /release/rc.stm

        +------------------[ vcs rev: 123 ]-----+
        | ::Master # Source file                |
        +---------------------------------------+
        | Name: Release Client                  |
        | Component: ~                          |
        | Description: Basic release criterion  |
        | Owner: some.guy@example.com           |
        | Various ISTQB BS: this; that...       |
        |                                       |
        | Here the body sterts...               |
        |                                       |
        | # Main #                              |
        | 1. Check A                            |
        |    > result is a                      |
        | 2. Check IMAPIsm        {proto==imap} |
        | 2. Check POP3ism        {proto==pop3} |
        |    > result is OK                     |
        +---------------------------------------+


*   QA operator requests for Slave (i.e. a variation for
    his specific needs); text/plain version.  Notice how revision
    number is passed down to the Slave

        GET /release/rc.stm?os=7&proto=imap
        Accept: text/plain

        +---------------------------------------+
        | ::Slave # Slave template              |
        +---------------------------------------+
        | Stm: /release/rc.stm                  |
        | Stm Revision: 123                     |
        | Params: os=7; proto=imap              |
        |                                       |
        | Here the body starts...               |
        |                                       |
        | # Main #                              |
        | 1. Check A                            |
        |    > result is a                      |
        | 2. Check IMAPIsm                      |
        |    > result is OK                     |
        +---------------------------------------+

*   or they may like HTML better (and POP3 rather than IMAP)...

        GET /release/rc.stm?os=7&proto=pop3
        Accept: text/html

        +---------------------------------------+
        | HTML # Generated from Slave           |
        +---------------------------------------+
        | # HTML version of above...            |
        | # With POP3 step instead of IMAP step |
        |                                       |
        :                                       :
        '                                       '


### Flow diagram ###

Even more graphical from time POV.

     User  :  App  :  Repo : Master : Slave
    =======================================
       |       |       |       |       |
       |       o ----> |       |       |
       |       | init  |       |       |
       o ----> |       |       |       |
       | GET   |       |       |       |
       | /rc?a o ----> |       |       |
       | =b    | load  |       |       |
       |       | <---- o       |       |
       |       |  mst  |       |       |
       |       |       |       |       |
       |       o ------------> |       |
       |       |       | gen(a |       |
       |       |       | =b)   |       |
       |       | <------------ o       |
       |       |       | slv   |       |
       |       |       |       |       |
       |       o --------------------> |
       |       |       |       | rndr  |
       |       | <-------------------- o
       |       |       |       | html  |
       |       |       |       |       |
       | <---- o       |       |       |
       |  html |       |       |       |
       |       |       |       |       |
    =======================================



Layers
------

    DAL         | BLL           | PL
    ========================================
    Repo        : Master        :
                :               :
                : Slave         :
                :               :
                : Condition     :
                :               :
                :               :