fix tables test bug
make the json query execute without lots of complex functions
change README to explain overall architecture better.
abstract the db name away into a constant
fix doc nit for db-pg function.