Capisso

Capisso is organisation management tool that tracks student projects.

Demo

You can access Capisso at https://capisso.jedrobertson.com to test the application. You will need to login with a aucklanduni.ac.nz account that has been whitelisted, contact the maintainers if you should be, but are not, whitelisted.

Environment Setup

1. Ensure Node.js v12 and Yarn v1.2.x are installed and on the system path.
2. Ensure ASP.NET Core 3.1.x is installed on on the system path.
3. Ensure MariaDB 10.4 is installed, configured and running. Guide for linux systems
4. Create a MariaDB database with name capisso.
5. Create a MariaDB user with username efcoreuser@localhost and password password.

CREATE DATABASE capisso;
CREATE USER 'efcoreuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON `capisso`.* TO 'efcoreuser'@'localhost';

Run the Application

1. In the server directory, run dotnet run.
2. In the client directory, run yarn followed by yarn start

Test the Application

1. In the server directory, run dotnet test.
2. In the client directory, run yarn test

Creating Migrations

1. Modify Entity classes or database context
2. Run dotnet ef migrations add <MigrationName>
   OR in the Package Manager console: PM> Add-Migration <MigrationName>
3. Restart the server or manually apply the migration using: dotnet ef database update
   OR in the Package Manager console: PM> Update-Database

Deploy the Application

1. See here for instructions