OVERVIEW

SUMMARY

The Key Tracker allows the Facilities Keys Office to manage their key inventory.  The existing key tracking application, which was developed 15 years ago, currently resides on an old VAX and Ingres database.  We have been asked to migrate it to a web-based application with an Oracle database.

GOALS

• Migrate the application while the existing environment is still stable
• Create a user-friendly interface that makes it easy for the Keys Office to get their job done

TEAM

Programmer: Joshua Dale
DBA: Peter Maloof

CUSTOMERS

The Keys Office.

TECHNICAL

SVN LOCATION

svn+ssh://svn.mit.edu/pmdashboard

SERVER LOCATION

ppl-r1.mit.edu

DATABASE

Key Tracker runs on Oracle on ppl-r1.mit.edu .

There are three instances: production, development, and test (for unit testing). The testing database data may be eradicated at any time by unit testing scripts, and should not be used for development or any other data you wish to keep.

Here's the TNSNAMES info for dev and test:
keysdev =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS=(PROTOCOL=TCP)(HOST=ppl-r1.mit.edu)(PORT=1521))
)
(CONNECT_DATA=(SID=PPLDEV))
)

keystest =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS=(PROTOCOL=TCP)(HOST=ppl-r1.mit.edu)(PORT=1521))
)
(CONNECT_DATA=(SID=PPLTEST))
)

Contact Janet Riley Bowker or Peter Maloof for login information.

DEVELOPMENT ENVIRONMENT

PHP 5.2
Cake 1.1.15.x (the latest stable, non 1.2 version)
Oracle - whatever version Ops currently recommends
Apache - whatever version Ops currently recommends

FUNCTIONALITY

The functionality will match the current system. Functionality is fully described in the Key System User Guide printout. Most user actions are CRUD - create, read, update, or delete records. Functionality includes:

• CRUD a key
• CRUD room information
• CRUD key holder information
• CRUD department information
• assign keys
• transfer keys from one holder to another
• keyoholder returns key
• keyholder loses key
• show key inventory
• show rooms and keys brief list
• show key inventory
• show key holders and their keys
• show keys assigned to key holders
• show report list
• run reports

We need more information about reports. The user guide names nine reports, but doesn't give a detailed description of what they show. We may be able to copy the SQL from the existing system.

PROJECT PLAN

This will be an agile-flavored project, using several short iterations with visible results at the end of each. The order of iterations may change.

Iterations and tasks are broken down here .