Difference between revisions of "Online Records Keeper V3"

From AmtWiki
Line 84: Line 84:
  
 
1.4) I have a question that isn't covered here, who do i ask?
 
1.4) I have a question that isn't covered here, who do i ask?
Send an email to Tyedye ([email protected]) or go the forum at the E-Samurai (http://www.dragonspine.net/samurai/forums/viewforum.php?f=13).
+
Send an email to Tyedye ([email protected]) or go the forum at the E-Samurai (http://www.electricsamurai.com/forums/viewtopic.php?f=13&t=26720).
  
2.) Technical Crap
+
'''Technical Crap'''
 +
The ORK3 is architected primarily as an SOA (Service-Oriented Architecture), comprised of about 20 services. It is MySQL/PHP based. Most of the services are XML SOAP via nusoap. Search services and a few others are RESTful JSON services.
  
2.1) What technologies does the O.R.K use?
+
The ORK3 UI is an MVC/template application written in PHP which sits on top of the ORK3 SOA. Template syntax is via ob_start() (that is, PHP), and the UI relies heavily on jQuery. The ORK3 SOA API is strictly enforced in the UI implementation, meaning that it can be transplanted to other servers and modified, while sharing the primary ORK3 service dataset and functionality. The UI is nominally ready-to-move, so a simple SVN checkout & config process should get you a local UI copy working against the canonical ORK3 SOA. The ORK3 Authorization service can be used as a poor-mans SSO for various Amtgard tools.
It uses a MySQL database.  
 
  
2.2) What kind of back ups exist? How safe is the data?
 
  
 +
'''How do I request a new feature?'''
  
2.3) How often does the O.R.K. get patched?
 
 
 
2.4) How do i request a new feature?
 
 
Go the forum at the E-Samurai (http://www.dragonspine.net/samurai/forums/viewforum.php?f=13).
 
Go the forum at the E-Samurai (http://www.dragonspine.net/samurai/forums/viewforum.php?f=13).
  

Revision as of 23:51, 5 February 2014

The Online Record Keeper V3, commonly referred to as the ORK3, is the central record keeping online database for Amtgard. Accessed via AmtgardRecords.com, it helps keep track of players; their credits and awards; parks and where they play; and a myriad of other details. It is maintained by each park's officers - typically the Prime Minister - and is the universally accepted tracking tool for the game.

ORKlogo.png
Direct Links
ORK3 Website


The Online Record Keeper software & website.

Development by Megiddo (ORK Service & Basic UI)and Talen (Data import from ORK2),

Testing & QA: Torig Headbasher

Administration: Linden Sylvanista

This new ORK is based around the concept of users with privileges. Every player listed in the system is also a system user with more or less privileges to do work (segregated at persona, Park, and Kingdom levels). Events, calendar dates, tournaments, companies and a few other items are now first-class or tier-1 items which the system understands and can work with.

The system is currently undocumented and is in an "in development" stage of stability and functionality. The primary components that remain unimplemented are the Treasury, Data Import/Export, Map, Calendar, and Tournament systems.

If you are interested in specific functionality or access, please contact Torig or me for access to the Bugzilla. We will try not to use e-sam or facebook as a bug reporting tool in the long-term.

Also, please keep in mind that the ORK3 is designed as an open service, so if you have a really great idea and know a programmer, you do not need our permission to extend this version of the ORK (see the TROLL as a primary example of the types of tools we are working to promote). We reserve the right to steal good ideas.


This online tool has become the be all end all source for records on our players. It makes a Prime Minister's job much easier by tracking credits, Dues, Awards and a myriad of other information. It also generates a number of reports that are useful to chapter Prime Ministers and Monarchs.


In addition to this information, the ORK has expanded to encompass a number of additional projects:

History of the Online Records Keeper:

  • The Original ORK was created in 1999 by Rewth, originally for just the Northern Holdfast. It was soon made available for the whole Empire of the Iron Mountains, and then for all of Amtgard in 2002. All kingdoms now use the ORK including the Wetlands, the longest holdout.
  • On Aug 19, 2013, The Online Records Keeper version 3 (ORK3) came online as a replacement for the original Ork filling the need to expand with the changes in Amtgard as a whole. The Circle of Monarch's issued the creation of a new version of the ork that would allow better tracking of statistics at each park as well as allow a better flexibility of changes with the upcoming rules revision of V8. And thanks to the tireless effort of Megiddo and his team the vision of the ORK will carry Amtgard on in the years to come.


===A Prime Minister's Guide=== (Recommended that you watch the instructional video link at the bottom of this page first.)

Logging In

  1. Start Here and Log in (upper right hand corner.)

Adding credits

  1. Go to your park page. You can use the park search in the upper right hand corner.
  2. On the left side of the page you should see
    • Enter Attendance <----- Click This one.
    • Enter Awards
    • Search Players
    • Park Heraldry, Players
    • Companies and Households
    • Treasury
    • Park Map
  1. Enter the information in the box now on the left, make sure all information is correct before saving.
  2. Repeat as necessary.

Transferring Players

Only the Prime Minister of the chapter that they are transferring too can move a player's records.

  1. Log in
  2. Click on the 'Player List' option from the side bar on the right.
  3. The player listing will appear below the center bar on the main portion of the page.
  4. Chose the player you wish to transfer.
  5. Chose the 'Player Info' button on the top right.
  6. On the bottom Right above the center bar you'll see a drop down menu with the park they play in now listed as 'Current Chapter'.
  7. Chose the chapter that you wist to transfer them too from the list.
  8. choose the 'Apply Changes' option.

Fequently Asked

1.) About the O.R.K.

1.1) What is the O.R.K.? The O.R.K. is a web accessible database for Amtgard, a live action role playing society. It tracks player information, awards, titles, credits and a myriad of other information. It also generates a number of reports that are useful to chapter Prime Ministers and Monarchs.

1.2) Can my chapter use the O.R.K.? Most likely yes. Assuming you are a recognized chapter within Amtgard, all you have to do is send an email to Tyedye ([email protected]) and ask her to set you up. Be sure to include the following information: Your chapter's name, the kingdom you belong to (or freehold if you have no kingdom), your chapter's size (shire, barony, duchy, etc), and two passwords for your chapter, one for the PM and one for the monarch.

1.3) What does O.R.K. stand for? Online Record Keeper. And it comes from the Oh-So-Brilliant mind of Sir Brennen Macgregor (or so we'll let him believe).

1.4) I have a question that isn't covered here, who do i ask? Send an email to Tyedye ([email protected]) or go the forum at the E-Samurai (http://www.electricsamurai.com/forums/viewtopic.php?f=13&t=26720).

Technical Crap The ORK3 is architected primarily as an SOA (Service-Oriented Architecture), comprised of about 20 services. It is MySQL/PHP based. Most of the services are XML SOAP via nusoap. Search services and a few others are RESTful JSON services.

The ORK3 UI is an MVC/template application written in PHP which sits on top of the ORK3 SOA. Template syntax is via ob_start() (that is, PHP), and the UI relies heavily on jQuery. The ORK3 SOA API is strictly enforced in the UI implementation, meaning that it can be transplanted to other servers and modified, while sharing the primary ORK3 service dataset and functionality. The UI is nominally ready-to-move, so a simple SVN checkout & config process should get you a local UI copy working against the canonical ORK3 SOA. The ORK3 Authorization service can be used as a poor-mans SSO for various Amtgard tools.


How do I request a new feature?

Go the forum at the E-Samurai (http://www.dragonspine.net/samurai/forums/viewforum.php?f=13).

The ORK source is now hosted on Google Projects.

[View Information Here]

It includes a sample config file, sql setup file, and a small PHP installer that should set up most of what you need to get started hacking.

On that note, I am actively seeking contributors to this project. If you are interested, please drop me or MHoG a line. I would prefer for this to NOT be a solo project, since it means your features and bugs get fixed faster, and there's less risk to the project if I can't contribute anymore.

If you know an HTML/CSS/Javascript or PHP/MySQL developer, please ask them if they'd be interested in contributing.

My next step is to finalize and verify the federation capabilities via the new JSON API interface. That will take a few weeks. After that, I will be able to return to our regularly scheduled bug & feature list.


ORK3 Admin Reports: [Notes]

Links