Skip to content

WING-NUS/SSID

master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
app
 
 
bin
 
 
 
 
db
 
 
doc
 
 
lib
 
 
log
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Student Submission Integrity Diagnosis

Student Submission Integrity Diagnosis (SSID) is a Ruby on Rails web application suite for managing courses, assignments, staff, teaching assistants, students, and student code submissions and most importantly, to detect and visualize plagiarism among student code submissions.

SSID works with lexers based on ANTLR4 Grammars so if you can find / write a grammar for it, SSID can detect and visualize plagiarism for it (scroll down and click on the guide on "Adding support for new language in SSID" to learn the steps needed to add a new grammar). SSID uses the JavaScript InfoVis Toolkit for its plagiarism visualization. Code display and syntax highlighting is handled by google-code-prettify. The file upload preview feature makes use of JSZip.

Table Of Contents

Prerequisites


NOTE: If you are using a Windows OS, please ensure that you have a linux environment to make changes to the code and run it in either the development or production mode. This is because some functions like fork are not supported by the Windows OS. To run a linux environment on Windows, you can either


  1. Ensure you have Java 11 (revision 11 or later) installed in your Computer.
  2. Ensure that you have installed Ruby (v2.6.6) and bundler (v2.1.4)
  3. Since the application uses MySQL as its database server, please ensure that you have installed MySQL 8.0.

Setup and Configuration

Before following the below instructions, please ensure that you have met all the prerequesties listed

  1. Clone SSID's source code onto your computer

    git clone https://github.com/WING-NUS/SSID.git
  2. Go to config/database.yml and modify the file by changing the username and password fields with your MySQL database settings (Please do it for all the 3 listed databases in the file)

  3. Now, go to config/envionments/ and add the respective line to the respective file(s)

    • Under config/envionments/development.rb & config/envionments/test.rb, add the below line:
    config.eager_load = false
    • Under config/envionments/production.rb add the below line:
    config.eager_load = true
  4. Open your terminal and navigate to the code directory. Run bundler to install the necessary gems (including rails) from the root directory of SSID:

    bundle install

    #Use the following solution if you have problem "Your bundle is locked to mimemagic (0.3.5)"

    https://stackoverflow.com/questions/66919504/your-bundle-is-locked-to-mimemagic-0-3-5-but-that-version-could-not-be-found
  5. Execute the following command in the root directory of SSID depending on which mode you wish to run the app:

    • Production Mode
     rake db:migrate RAILS_ENV=production
     rake db:seed
     
    • Development Mode
     rake db:create db:schema:dump db:migrate RAILS_ENV=development
     rake db:seed
     
  6. Running SSID: Execute the following command in the root directory of SSID depending on which mode you wish to run the app:

    • Production mode: configure Apache to serve web requests to SSID

    • Development mode:

     RAILS_ENV=development rails server
     

Site Map

Contact

To request features, you may want to log an issue on Github.

For other inquiries, please contact us with subject starting with [SSID]

License

SSID is licensed under the [GNU Lesser General Public License] gpl