README.md

Some considerations about Fortsu's workout log:

1. How it works 1. Infrastructure
2. Sources 1. Structure 2. External dependencies 3. License

How it works

Basicaly it is a website to track sport (running, cycling, swimming and hiking) activities. What makes it different from other options is the advantage of accessing to source code (see License for more details) by anyone. Usage is absolutely free of charge.

In addition any user can at anytime export all his/her information (tracks, metadata) from the system. Tracks are exported as GPX files and database metadata as JSON.

Activities can be uploaded in three ways:

• Entering data manually using a form.
• Uploading file.
• Using Garmin Connect plugin.

Supported source data formats:

• GPX v1.x (schema)
  • GPX+ To support additional data like heartrate, cadence, laps, etc.
• TCX v2
• FIT

Infrastructure

It is a Linux Apache MySQL PHP (LAMP) web application hosted on a virtual private server running Ubuntu 13.10.

Sources

Programming languages used are PHP 5.x and javascript.

Additional PHP5 libraries:

• php5-gd
• php5-json
• php5-mcrypt
• php5-mysql
• php5-xsl

Structure

• classes
  • Utils
    • Graphs
    • Parser
• config
• public
  • admin
  • communicator-api
  • estilo
  • fonts
  • forms
  • images
  • js
  • oauth
  • osm
  • tmp
  • users
• reports
• scripts
  • db_releases
  • GarminFit
• tests
  • data
• transform

External dependencies

Need to be satisfied on server side:

• GarminFit
• jQuery
• jQueryUI
• OpenLayers
• phpMyGraph
• composer
  • log4php
• TrueType fonts
  • Ubuntu
  • Rock Salt

Need to be satisfied on client side:

• Garmin Communicator plugin (only when uploading activities using it)
  • Garmin official version
  • GNU/Linux version

License

Copyright (C) 2012-2014 by David García Granda (dgranda at gmail dot com).

"entrenos" is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

"entrenos" is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with "entrenos". If not, see http://www.gnu.org/licenses/.

A copy of the License can be retrieved from http://www.gnu.org/licenses/agpl-3.0.html and is also available in the file called "COPYING".