TrackerDB readme file
----------------------
Author: Greg Feigenson
Version: Beta-PGF1

Contents:
  1 - Requirements
  2 - Installation
  3 - SQL script
  4 - Notes

1 - Requirements
#################
PHP5 - this might work on 4, haven't tested. 
       PHP5 is faster and has better OO support

PostgreSQL - Tested on 8, but probably works on 7x

Javascript - some of the pages use JS

2 - Installation
#################
NOTE: some files are unix formatted, some win32. Might want to convert them.
      I'll work on this later.

1) Uncompress the archive 

2) in the root of the directory from above there's a folder called "sql"

3) run the script called "backup.sql"

NOTE: it's very possible that this script won't work and you'll need to clean 
      it. I still haven't set up permissions or anything yet so it's very, very 
      rough and wll require some gentle massage. See Section 3.

4) Now that you have the DB, go into root/includes

5) edit config.inc.php

6) definately fill out the database portion

7) I recomment filling out locative, but this will be updated in another version 
   and
   is not necessary.

NOTE: I ask that you not change the copyright please so people know
      how to get the software and who wrote it.

8) you now have a login called "admin" with password "test"

9) log in, create customers and then do things

3 - SQL Script
###############
Oh yeah, it's funky. Here's the breakdown:

2 groups: web and dev. One will be for showing on the site, the other for
building the app.

"dbowner" is a user I made up to own everything. You should do a search/replace
to correct that. Also, there's a default user: admin w/ pass "test." The
pass is an MD5 hash, so feel free to edit it.

I'm not sure if the script will work, haven't tested it too much. Please
email me whatever issues happen - I'm a bit low on testing boxes.

4 - Notes
###########
You can find more information on my website at www.epiphanic.org.

This is a first cut, very very rough. It combines some of my first
RDBMS code with some early PHP work. I need to go back in and make
the code elegent, as opposed to hacking things out.

Please tell me any ideas, and see the TODO.txt file for more of
an idea of what I'm contemplating. I don't have a whole lot of time
these days, but I'll continue to release as often as possible.

I can be reached at kog@epiphanic.org if you have questions, suggestions et al.
http://pgfoundry.org/projects/trackerdb/ is, as always, my PG Foundry site, 
which oddly enough doesn't give me a PG database... dunno how I'm going to put 
up a demo.


May 26, 2005 - Greg Feigenson