Latest Dev Build

http://bdev.c4gnv.com.s3-website-us-east-1.amazonaws.com/

Business Portal

C4GNV is a member brigade of Code for America, the goal of this project is to make it easier to start a business in Gainesville by providing people easy access to permits and zoning information. The project is a lightweight website written in Typescript and Angular 2, using open data sources as a persistent backend.

The inspiration for this service is to eventually be able to expand to be like the Business Portal for San Francisco, however we're starting with the Permit Locator functionality only.

Contributing

We welcome your contribution! Please see our contributing guidelines.

Install

You want to run this bad boy locally? Let's do it.

Install Tools

• Install nodejs from https://nodejs.org/en/

• Install npm from https://www.npmjs.com/

  • It is suggested that you use yarn as an alternative to npm for package management. If you don't already have it installed, you can follow yarn's own documentation to install it. The documentation for the business portal will refer to yarn in place of npm, but they can be used in the same way.

• Install the latest version of GIT from https://git-scm.com/

Get That Repo

From the command line execute git clone https://github.com/c4gnv/business-web.git to get this repository down to your local machine

Install the Dependancies

Run yarn install in the project's root directory

Start it up

Run yarn start and head over to http://localhost:8080/ you should now see the latest and greatest.

How This all Fits Together

=======

Model Permit sites

https://businessportal.sfgov.org/permits-licenses

Possible opendata service

Permits by business type

Permit Details

JSON Source data for associations, maintained by the city

Business Types

Business Permits

Architecture Diagram

Data Structures

BusinessType

This is the type of business that a person is trying to open. These are defined by the city of gainesville. The schema for a BusinessType is as follows:

business_type: string;
business_category: string;
requiredPermits: Permit[];
conditionalPermits: Permit[];

Permit

This is a permit that is required for a particular BusinessType. The schema for a Permit is as follows:

friendly_name: string;
permit_location: {
    url: string;
};
online_submission: {
    url: string;
};
permit_description: string;
permit_name: string;

The permit locator page makes two http requests to Socrata (see above URLs) and generates an array of BusinessType structures. This structure is populated with types and permits from Socrata.