Foodloop-Server/README.md

LocalSpend (Server)

Looking to discover if the value of spending local can be measured, understood and shown.

This repository contains the server application for the LocalSpend system. See also:

• the Web application; and
• the mobile application.

Current Status

Branch	Status
master
development

Table of Contents

• Tech Stack
• Features
• Installation
• Configuration
• Usage
• Testing
• Code Formatting
• Documentation
• Acknowledgments
• License
• Contact

Technology Stack

The server app. is written in Perl.

Technology	Description	Link
Mojolicious	Perl Web framework	Link
PostgreSQL	Relational database	Linke

Features

This server app. provides:

• user creation, updating and deletion;
• organisation creation, updating and deletion;
• transaction logging;
• transaction history analysis; and
• leaderboard generation.

Installation

1. Clone the repo. to your dev. environment (git clone git@github.com:Pear-Trading/FoodLoop-Server.git);
2. enter the new directory (cd FoodLoop-Server);
3. install the dependencies:

   • cpanm --installdeps . \
     --with-feature=sqlite \
     --with-feature=codepoint-open
     

   • if you are using a PostgreSQL database, replace --with-feature=sqlite with --with-feature=postgres.
4. install the database:
   • development supports both SQLite and PostgreSQL, however production uses PostgreSQL;
   • for this example we will use SQLite;
   • as the default config. is set up for this, no configuration changes are needed initially.
   • run ./script/deploy_db install -c 'dbi:SQLite:dbname=foodloop.db'.
5. set up the development users:
   • ./script/pear-local_loop dev_data --force
   • DO NOT RUN ON PROD.
6. start the minion job queue:
   • ./script/pear-local_loop minion worker
7. import ward data:
   1. Download the CSV(s) from here; and
   2. run the following command:

      •     ./script/pear-local_loop minion job \
            --enqueue 'csv_postcode_import'  \
            --args '[ "⟨ path to CSV ⟩ ]'
            ```
        

8. set up postcodes:
   1. import Code-Point Open: - a copy is included in etc/; - run ./script/pear-local_loop codepoint_open --outcodes LA1
      1. assign postcodes:

      ./script/pear-local_loop minion job
      --enqueue entity_postcode_lookup ```

Configuration

App. configuration settings are found in pear-local_loop.⟨environment⟩.conf.

Firebase Cloud Messaging (FCM) credentials should be placed in a file called localspend-47012.json in root.

Usage

• Run morbo script/pear-local_loop -l http://*:3000 to start the server; and
• run ./script/pear-local_loop minion worker to start the Minion asynchronous job scheduler.

Database Scripts

To upgrade the database after making changes to commit:

1. Increment the $VERSION number in lib/Pear/LocalLoop/Schema.pm;
2. run ./script/deploy_db write_ddl -c 'dbi:SQLite:dbname=foodloop.db'; and
3. run ./script/deploy_db upgrade -c 'dbi:SQLite:dbname=foodloop.db'.

Run ./script/pear-local_loop recalc_leaderboards to update the leaderboards.

Testing

• Run prove -lr to run the full test suite using Test-Simple (when using an SQLite database); and
• run PEAR_TEST_PG=1 prove -lr to run the full test suite (when using a PostgreSQL database).

Code Formatting

TODO

Documentation

TODO

Acknowledgements

LocalLoop is the result of collaboration between the Small Green Consultancy, Shadowcat Systems, Independent Lancaster and the Ethical Small Traders Association.

License

This project is released under the MIT license.

Contact

Name	Link(s)
Mark Keating	Email
Michael Hallam	Email