brisag / recreational_rails

partner project one

▒█▀▀█ █▀▀ █▀▀ █▀▀█ █▀▀ █▀▀█ ▀▀█▀▀ ░▀░ █▀▀█ █▀▀▄ █▀▀█ █░░   ▒█▀▀█ █▀▀█ ░▀░ █░░ █▀▀
▒█▄▄▀ █▀▀ █░░ █▄▄▀ █▀▀ █▄▄█ ░░█░░ ▀█▀ █░░█ █░░█ █▄▄█ █░░   ▒█▄▄▀ █▄▄█ ▀█▀ █░░ ▀▀█
▒█░▒█ ▀▀▀ ▀▀▀ ▀░▀▀ ▀▀▀ ▀░░▀ ░░▀░░ ▀▀▀ ▀▀▀▀ ▀░░▀ ▀░░▀ ▀▀▀   ▒█░▒█ ▀░░▀ ▀▀▀ ▀▀▀ ▀▀▀

Table of contents

• General info
• Database Schema
• Learning Goals/Areas of Focus
• Technologies
• Setup
• Features
• Status
• Contact

General info

This project is a basic Rails app that creates web pages with CRUD functionality allowing users to interact with database resources that have a one-to-many relationship.

We designed out database around the theme of National Park backcountry offices and trails; interpretation/visitor offices and programs.

Database Schema

Learning Goals / Areas of Focus

• Design a one to many relationship using a schema designer
• Write migrations to create tables with columns of varying data types and foreign keys
• Use Rails to create web pages that allow users to CRUD resources
• Create instance and class methods on a Rails model that use ActiveRecord methods and helpers
• Write model and feature tests that fully cover data logic and user behavior

Technologies

Project is created with:

• Ruby version 2.5.3
• Rails version 5.2.4.3
• PostgeSQL

Setup

To run this program:

1. From this repository, press the green "clone" button and then copy the link by pressing the Copy To Clipboard icon.
2. Navigate to the folder where you want to save it and enter: ''' $ git clone '''
3. Navigate into the new folder containing this project ''' $ cd recreational_rails '''
4. Install required gem files ''' $ bundle install '''

Connecting to the database & starting the server:

1. Make sure the app PostgreSQL is running
2. Run the following commands: ''' $ rails s $ rails db{drop,create,migrate,seed} '''

View in browser

1. Open the browser of your choice and navigate to: ''' http://localhost:3000/ '''

Features

List of features ready and TODOs for future development

• View lists of Backcountry Offices, individual offices with their details, and associated trails
• View lists of Parks, individual parks with their details, and associated visitor programs
• Navigation bar with links to index pages containing a full list of a type of resource (e.g. all programs)
• All types of resources can be created, updated, and deleted
• Sort displayed resources alphabetically using a link
• Sort by number of trails/programs using a link
• Filter displayed records by a numeric threshold (trails with an elevation gain higher than the value, programs with greater participant limit than provided number)
• Matching and partial match name search of backcountry offices or parks using a search bar

To-do list:

• Add feature tests to cover the exact and partial name search methods
• Additional refactoring

Status

Project is: in progress

Contact

Created by

• @brisag
• @joemecha

~ feel free to contact us ~