ToS;DR 2

A web app to submit and review points about services for http://tosdr.org.
Written in JavaScript with help of the meteor framework (https://www.meteor.com).
Data is saved in a MongoDB.

Current state

Highly experimental, incomplete, insecure and not scalable.
But a great start for 21 working hours :-)

How to start in development mode

Install meteor:

curl https://install.meteor.com/ | sh

Cd into the project root directory (where this README is located) and enter:

meteor

Open [http://localhost:3000] (http://localhost:3000) in your browser.

You need to sign in to see something interesting. You can sign in/up yourself with the menu in the top right corner. Email addresses are currently not verified and "Forgot password ?" does not work.

How to make a user to a moderator

The most functionality is hidden from normal users. Therefore you need to make one user to a moderator in order to see all functionality.

First you need to open the mongo shell in parallel to the running meteor app.

meteor mongo

Then you need to find the correct user id and add the role

db.users.find().pretty() // find _id
db.users.update({_id: 'USER_ID'},{$set: {roles: {moderator: true}}})
db.users.find().pretty() // should have roles attribute now

You can get the user of the current logged in user also in the browsers console by

Meteor.userId()

Import from [tosdr-build] (https://github.com/tosdr/tosdr-build)

Requirements

• You need to have mongodb-clients installed. (on debian like distribution, run apt-get install mongodb-clients)
• you need the tosdr-build repo: git clone https://github.com/tosdr/tosdr-build

How to run

.tools/import.sh

There are 2 ENV variables that might need to be set up for development environment:

MONGO_SERVER=127.0.0.1:3001 TOSDR_BUILD_DIR='/path/to/tosdr-build' .tools/import.sh

Publish/Export

As moderator you can export (=publish) points, services and topics to a downloadable zip-file. The exported files should be compatible with the one imported from tosdr-build.

Running tosdr2 locally

The import described above does not work correctly if there is already data in mongodb. This is what I do instead when updating the mongo database in development:

• (DON'T DO THIS IN PRODUCTION AS IT WILL LEAD TO DATA LOSS!) in meteor mongo, run:
  • 'db.points.remove({})'
  • 'db.services.remove({})'
  • 'db.topics.remove({})'
• Make sure tosdr-build is checked out to latest master with no uncommitted changes.
• In your tosdr2 checkout, with meteor running, do:
  • MONGO_SERVER=127.0.0.1:3001 .tools/import.sh
• Go to http://localhost:3000, log in as a moderator user, click 'Publish'
• Download data.zip
• In your tosdr-build checkout,
  • cd src
  • rm points/*.json
  • rm services/*.json
  • rm topics/*.json
  • unzip -u ~/Downloads/data.zip
  • chmod ugo-x */*.json
  • git status
• If no modified files show up in git status, Mongo and tosdr-build json-files are in sync.

You can now edit points on http://localhost:3000 and later repeat the Publish steps to update tosdr-build.

License

AGPL-3.0+ (GNU Affero General Public License, version 3 or later)

See https://tosdr.org/legal.html for more details on the legal aspects of the project.