Role

Projects are the top-level organizational unit of TaskTracker.  Each task list belongs to a project. 

Initialization

A project needs to be initialized before it can be accessed.  The project can be initialized by sending a POST request to $(TASKTRACKER_INSTANCE_HOME)/project/initialize.  Likewise a project can be uninitialized by sending a POST request to $(TASKTRACKER_INSTANCE_HOME)/project/uninitialize.  This request will only succeed if REMOTE_ADDR=127.0.0.1, to prevent external initialization of the tasktracker.  This step can be bypassed globally by filling in the environment key "initialization_not_required"; the easiest way to do this is to add a line like "fill_environ initialization_not_required = True" to your development.ini configuration file.

Locking

A project can also be locked (made read-only) or unlocked by sending a POST request to $(TASKTRACKER_INSTANCE_HOME)/project/lock or /unlock, respectively.  This request will only succeed if the authentication layer recognizes the logged-in user as a ProjectAdmin.  This is a recently-added feature; it is believed to work fully but has not been rigorously tested, and no UI work has been done to indicate a project's read/write status to the user.