Geo2tag e-Tourism Service (GeTS)

h1. Use Cases

{{toc}}

category-channel = channel in geo2tag, corresponding category of GeTS

h2. Audio Guide 

h3. Scenarios in GeTS Web Client

h4. Create track

* User logs into GeTS Web Client using his Google Account

* Then User goes to the "Tracks" page

* At this page User hits button "Create track" and as the result creation menu will appear

* In this menu User can enter some name, some description and some other information which belongs to the track 

* After that User can add some points to the track by pressing "Add point" button and then pressing some space on the map

* All points will be displayed as a list, where user can enter the name and add some information about a point, including Audio Track 

* Also every point in a list will have edit and delete buttons 

h2. Points 

h3. Load points

* Send to GeTS (loadPoints) list of categories, coordinates of circle center and radius

* GeTS loads from geo2tag (filterCircle) list of category-channels with 2D filter (circle center and radius)

* GeTS merges list of points from channels and remove duplicates.

* GeTS returns list of points.

h3. Update point info (categories and data)

* Send to GeTS (updatePoint) point with list of categories and point data

* GeTS search category-channels with old version of point

* if point data is differ then exists, then GeTS removes point from category-channels, else GeTS removes point from old category-channels

* GeTS add point to geo2tag (writeTag) to new category-channels (or to all category-channels if poind data was changed)

* GeTS returns OK answer

h3. Add point

* Send to GeTS (addPoint) point with list of categories and point data

* GeTS add point to geo2tag (writeTag) to all category-channels

* if requested category-channel doesn't exists then GeTS creates (addChannel) category-channel

h3. Remove point from category-channel(s)

*(We need function in geo2tag for removing points from channels)*

*(We need function in geo2tag for removing channels)*

* Send to GeTS (removePoint) point with list of categories

* For each category GeTS:

*# loads point from category-channel (filterChannel); 

*# removes deleted point from list;

*# deletes old category-channel (*need a method*);

*# creates new category-channel (addChannel) and addes list of points (writeTag)

h2. Tracks

h3. Load track

* Send to GeTS (loadTrack) name of track

* GeTS loads track from geo2tag (filterChannel), if one exists

* GeTS returns track.

h3. Update track's info

* Send to GeTS (updateTrackInfo) with track's field to change: url, name or description

* GeTS makes update track info on geo2tag (alterChannel)

* GeTS returns OK answer

h3. Remove track

* Send to GeTS (removeTrack) name of track

* GeTS removes track from geo2tag (*need a method*), if one exists

* GeTS returns OK answer

h3. Add track

* Send to GeTS (addTrack) with name, description, url, activeRadius

* GeTS addes channel to geo2tag (addChannel), if there is no channel with given name in the system

* GeTS returns OK answer

h2. Categories

h3. Add category

* Send to GeTS (addCategory) with name, description, url

* GeTS addes channel to geo2tag (addChannel) like category, if there is no channel with given name in the system

* GeTS returns OK answer

h3. Get category

* Send to GeTS (getCategory) with the name of the desirable category

* GeTS loads category from geo2tag (filterChannel), if this category exists

* GeTS returns category with all points that it contains.

h2. Users

h3. Registration

h3. Authorization

h3. Quit session

* Send to GeTS auth-token (quitSession)

* GeTS calls quit session in geo2tag (quit)

* GeTS returns OK answer

h3. Remove user 

* Send to GeTS (removeUser) with name and password 

* GeTS calls delete user in geo2tag (deleteUser)

* GeTS returns OK answer