Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
bin
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

SnapHole API Server

Build Status MIT licensed

An app that receives a photo from a client app and sends a request to the City of Ottawa for pot hole repair.

Codeowners

Contact these people for information and ideas about how you may contribute :)

@devisscher, @vatdaell, @jsivakumaran

Install Dependencies

You must first install all dependencies using the latest version of NodeJS. Must have Docker and MongoDB installed beforehand.

Then you must clone 2 repos as follows in the same parent folder.

  • 📁 apps
    • 📁 Snaphole-Api
    • 📁 snaphole-webapp
$ git clone git@github.com:YOWCT/SnapHole-API.git
$ cd SnapHole-API
$ npm install
$ git clone git@github.com:YOWCT/snaphole-webapp.git
$cd snaphole-webapp
$npm install

Environment Variables

Add these variables in a file called .env at the root of SnapHole-Api. If you don't have credentials, contact someone in the Slack channel #Snap311.

LOCAL=127.0.0.1
PRODUCTION=prod_ip
APP_NAME=SnapHole.io
DOMAIN=http://localhost:8089
PORT=8089
DB_PASSWORD=password
MAILGUN_DOMAIN=mg.snaphole.io
MAILGUN_KEY=key
FROM_EMAIL=accounts@snaphole.io

AWS_BUCKET=snaphole
AWS_ACCESS_KEY_ID=key
AWS_SECRET_ACCESS_KEY=key

Docker Compose (start/stop)

From SnapHole-Api. Start the web server and the client.

$ docker-compose up

Start the API only

$ npm start

> SnapHole-API@0.0.0 prestart /Users/mac/Github/SnapHole-API
> jsdoc services/index.js -d public/docs


> SnapHole-API@0.0.0 start /Users/mac/Github/SnapHole-API
> node ./bin/www

server running on port: 8089

Using your favorite web browser visit http://localhost:8089.

If you started the system with docker, you can also visit the client by visiting: http://localhost:3000.

Client

Refer to the readme in the client app.

References

Open 311 Docs

Open 311 Endpoints

Open 311 Post Request

POST /dev/v2/requests.xml
Host: api.city.gov
Content-Type: application/x-www-form-urlencoded; charset=utf-8

api_key=xyz&jurisdiction_id=city.gov&service_code=001&lat=37.76524078&long=-122.4212043&address_string=1234+5th+street&email=smit333%40sfgov.edu&device_id=tt222111&account_id=123456&first_name=john&last_name=smith&phone=111111111&description=A+large+sinkhole+is+destroying+the+street&media_url=http%3A%2F%2Ffarm3.static.flickr.com%2F2002%2F2212426634_5ed477a060.jpg&attribute[WHISPAWN]=123456&attribute[WHISDORN]=COISL001

Useful docs

Deploy using Heroku

Host Images

IOS

Create React App && Docker

About

SnapHole - API server

Resources

License

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •