Difference between revisions of "FGdb"

From FreekiWiki
Jump to navigation Jump to search
(made more newbie-friendly)
Line 1: Line 1:
 
==Description==
 
==Description==
This is PHP code ( http://www.php.net/ ) that talks to a PostgreSQL database ( http://www.postgresql.org/ ). It is responsible for tracking all our gizmos and their statuses, all our volunteers and the hours they've worked, all our receipts for donations and sales, and more. Everything runs in a web browser.
+
FGdb is where lots of data about Free Geek is kept, including such things as volunteer names and hours, gizmo IDs and types, dollar amounts of donations we've received, and much more. It's a complex system, comprised of a [http://www.postgresql.org/ PostgreSQL] database and a [http://www.php.net PHP] front end.
 +
 
 +
You can access it through a web browser, provided you're inside the Free Geek building (not including the wireless network.) Just type the word '''data''' in the address bar (you know, where you'd usually type a big long URL like http://www.example.com.)
  
 
==Project Status==
 
==Project Status==
This code is in a constant state of change. There's always work needed.
+
This code is in a constant state of change. There's always work needed. The [[Coders]] group, which meets Tuesday evenings, is where to get started if you're interested in helping out. They also have an [http://lists.freegeek.org/listinfo/coders email list].
  
 
There is a proposal on [[FGdb goals for year end 2005]].
 
There is a proposal on [[FGdb goals for year end 2005]].
  
 
==Queue==
 
==Queue==
The [[RT]] queue for this project is called FGdb.
+
There is an [[RT]] queue for this project, which is where individual projects and upgrades are kept track of. It is called FGdb.
  
 
==Installation==
 
==Installation==
To install a copy of FGdb on your own computer, see [[Installing FGdb]]. ''(These instructions assume a FreekBox or other debian based system.)''
+
To install a copy of FGdb on your own computer, see [[Installing FGdb]]. You'll probably need the help of somebody from the coders group. ''(These instructions assume a FreekBox or other debian based system.)''
  
 
If you want to code on Free Geek's infrastructure, rather than set up your own environment, take a look at [[llama setup for FGdb]].
 
If you want to code on Free Geek's infrastructure, rather than set up your own environment, take a look at [[llama setup for FGdb]].

Revision as of 00:09, 5 January 2006

Description

FGdb is where lots of data about Free Geek is kept, including such things as volunteer names and hours, gizmo IDs and types, dollar amounts of donations we've received, and much more. It's a complex system, comprised of a PostgreSQL database and a PHP front end.

You can access it through a web browser, provided you're inside the Free Geek building (not including the wireless network.) Just type the word data in the address bar (you know, where you'd usually type a big long URL like http://www.example.com.)

Project Status

This code is in a constant state of change. There's always work needed. The Coders group, which meets Tuesday evenings, is where to get started if you're interested in helping out. They also have an email list.

There is a proposal on FGdb goals for year end 2005.

Queue

There is an RT queue for this project, which is where individual projects and upgrades are kept track of. It is called FGdb.

Installation

To install a copy of FGdb on your own computer, see Installing FGdb. You'll probably need the help of somebody from the coders group. (These instructions assume a FreekBox or other debian based system.)

If you want to code on Free Geek's infrastructure, rather than set up your own environment, take a look at llama setup for FGdb.

Sub-projects

  • Contacts -- Anything relating to tracking volunteers, donors, customers, or other contact information for people or organizations in the database. -- Martin Chase is working on these related projects.
    • Volunteer tracking and volunteer hours maintenance
    • Membership program tracking (people making regular cash contributions to Free Geek)
    • Sales receipts (we sell stuff to customers)
    • Donation receipts (donors give us stuff)
  • Gizmos -- Anything relating to tracking gizmos in the database.
    • new gizmo entry (at receiving)
    • editing existing gizmos
    • cloning of several similar gizmos at the same time
  • System checkout -- The process of tying a system's component gizmos to it, assigning an adopter to it, assigning an appropriate value and status to each gizmo, and attributing (in hours) the "value" of the system. This happens when a system is sent to the store, adopted, or granted out.
  • Reports -- Anything that only requires read access to the database.
    • volunteer reports -- who's in what program, who's waiting to get in, where are they in the process, etc. -- Douglas Howard is working on this.
    • gizmo reports -- how many gizmos of which types were received, recycled, etc.
  • Data Integrity and Cleaning -- Finding old problem in the data itself, removing them, and preventing their reoccurance. This is SQL intensive and less about PHP. -- David Jencks and Richard Seymour are working on this.

Unstarted sub-projects

  • Billing module (for organizations who want to drop off donation but need an invoice to pay instead of payment at time of drop off)
  • Recycling Pickup module (to track quantity and type of materials picked up, and rates we paid or received for that material)
  • Module for tracking borrowed equipment
  • Module for tracking issues with volunteers
  • Gizmo notes -- for tracking history of what happened to a gizmo with text notes, rather than just statuses. This would allow people working on specific types of gizmos to look back and see what happened to a specific motherboard or UPS (for example) and determine what works and/or what to do next.
  • Events Database

Development Stuff