Project management system implementing the Scrum Agile methodology. In heavy development.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
bin
config
db
lib
log
public
test
vendor/assets
.gitignore
CHANGES
Gemfile
Gemfile.lock
LICENSE
NOTES.md
README.rdoc
Rakefile
config.ru

README.rdoc

Project Useful

Project Useful is a Ruby on Rails-based project management system implementing the Scrum Agile methodology.

System Requirements

  • Ruby version 2 or later

  • Rails 5.2.1

  • Bootstrap 4

  • MySQL or MariaDB 5.1 or later

Database

The system is being developed on a system using MySQL 5.1.46. Later versions as well MariaDB should also work.

Create a database for production. If you plan to do development or testing of the system you'll also need a corresponding database.

Create a user for Project Useful and grant all rights to the databases to the user. Make sure to update your config/database.yml file with the appropriate database, username, and password.

Installation

Make sure you update your secret token before running the application! config/initializers/secret_token.rb

Author, Copyright, and License

Project Useful is copyright 2018 by William B. Hauck, www.wbhauck.com .

Project Useful is released under the GNU Affero General Public License. See the LICENSE file for details.

Sections still to write

  • Configuration

  • Database initialization

The datatbase currently needs to be setup manually. Login with admin privileges (root) and create a new database for Project Useful. Then grant permissions to a new database user that you want to own the database. Replace USER and PASSWORD with appropriate information.

create database project_useful;
grant all on projectuseful.* to 'USER'@'DATABASE_SERVER' identified by 'PASSWORD';
  • How to run the test suite

  • Services (job queues, cache servers, search engines, etc.)

  • Deployment instructions

ProjectUseful.org is currently running through Apache / Phusion Passenger. Setup a virtual host for the application similar to the following:

<VirtualHost *:80>
    ServerName "www.DOMAINNAME.org"
    ServerAlias "DOMAINNAME.org"
    DocumentRoot /path/to/project_useful/public
    ErrorLog "logs/www.DOMAINNAME.org-error_log"
    CustomLog "logs/www.DOMAINNAME.org-access_log" common
    RailsBaseURI /rails
    <Directory "/path/to/project_useful/public">
      Options FollowSymLinks Includes
      AllowOverride None
      Order deny,allow
      Allow from all
    </Directory>
</VirtualHost>