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
 
 
 
 
 
 
 
 
 
 
issf
 
 
 
 
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
a
 
 
img
 
 
 
 
 
 
svg
 
 
 
 
 
 

Information System on Small-Scale Fisheries (ISSF)

A global, open-source collaborative database of information on small-scale fisheries

screenshot.png

The ISSF homepage, accessible here.

About

The Information System on Small-Scale Fisheries (ISSF) is an open-source research project to source information on small-scale fisheries from across the globe. The project is built on top of Python and Django, PostGIS, Foundation, and Docker.

Development

Clone the git repository with:

git clone https://github.com/toobigtoignore/issf

cd to the issf directory: cd issf

Symlink (Or copy) the development compose file

ln -s docker-compose-dev.yml docker-compose.yml

Create a dummy .env file

cp issf_prod/.env.dist issf_prod/.env

Then spin up the database container. From within the issf directory run:

docker-compose up -d db

Next, acquire the test database so we can import it. There is an automated script to handle the process of importing and populating the database with the data dump called

./scripts/postgres_setup.sh

then run

./scripts/postgres_patches.sh

After that, launch the existing containers with:

docker-compose up -d

Go to the browser and type issfcloud.localhost, you should be able to see the site on your local machine.

Once the other containers are running, you will still need to install the npm packages on the ISSF container. Open a shell with ./scripts/issf_shell.sh and run the npm installation commands npm install.

Roadmap

  • v2.0.0
    • Upgrade to Django 2.0 and updated major Python libs
    • Migrated entire system to Docker containers with Docker Compose
    • Set up TravisCI
    • Set up NPM and Webpack
    • Added project documentation, written with Sphinx
    • Address all currently known bugs

Contributing

Read our documentation here to contribute. Thank you for contributing!

See our list of contributors here.