henryszex42s / teamform-seed Goto Github PK

This project forked from hkpeterpeter/teamform-seed

This project is an application skeleton. It is used for a HKUST Software Engineering Course (COMP3111/H) in Fall 2016/17. My goal: The project is not asking students to re-produce the sample project. We should encourage students to do something better than the TA.

Home Page: https://course.cse.ust.hk/comp3111/teamform/

License: MIT License

HTML 63.02% JavaScript 31.76% CSS 5.22%

teamform-seed's Introduction

teamform-seed modified the 5th times.... HAHA

The seed project for the team forming web application

Pre-requisites

Install git: http://git-scm.com/.

Install node.js and npm: http://nodejs.org/. Commands to test the installation:

git --version
node -v
npm -v

Clone the project

Please clone the repository at GitHub using git clone command:

git clone https://github.com/hkpeterpeter/teamform-seed
cd teamform-seed

Install Dependencies

In this course project, fixed version of key libraries (e.g. AngularJS 1.5.7) are included in app/lib folder to avoid discreprency. Other development dependencies (e.g. karma toolkit, http-server...) will be installed separately via:

npm install

After running this command, a new folder will be created:

node_modules - It contains the npm packages for the necessary tools we need to build and test our web application

Run the Application

We have preconfigured the project via a configuration file package.json. The simplest way to start this web application is:

npm start

After that, open a web browser (Google chrome desktop/mobile web browser is recommended) with the following URL: http://localhost:8080/index.html.

Directory Layout

LICENSE                 --> The software LICENSE of this open source project. Generated by Github
README.md               --> This README file (default README file for Github)
.gitignore              --> Git configuration file. It can be used to ignore files/directories from Git 
karma.conf.js           --> Configuration file for the Jasmine/Karma unit test framework. 
package.json            --> Configuration file for node.js and npm (Node Package Manager)
app/                    --> all of the source files for the application
  index.html            --> The front-end of the team form web application
  admin.html            --> The admin HTML page
  team.html             --> The team HTML page
  member.html           --> The member HTML page
  lib/                  --> Key libraries with fixed version (e.g. Angular JS 1.5.7) 
  js/                   --> User-defined JavaScript files
     admin.js           --> The JS file for the admin page
     index.js           --> The JS file for the front-end page
     team.js            --> The JS file for the team page
     member.js          --> The JS file for the member page
     site.js            --> The JS file containing functions shared by multiple pages
  unit_tests            --> The folder containing the unit test cases (Syntax: Jasmine/Karma)
     test_site.js       --> A sample test case

Testing

Running Unit Tests

We provide a Karma configuration file to run them.

the configuration is found at karma.conf.js
all unit test cases should be written inside the folder app/unit_tests

The easiest way to run the unit tests is to use the supplied npm script:

npm test

This script will start the Karma test runner to execute the unit tests. In this course, we will mainly focus on the branch and statement coverage. The output files will be stored inside the app/coverage folder.

Addtional information for COMP3111H students

Besides from web development, COMP3111H team needs to work on a mobile app (iOS and Android). We recommend your team to use Ionic framework [http://ionicframework.com/] (http://ionicframework.com/). Ionic framework is based on AngularJS. Features completed in Angular can be easily ported to Ionic.