Compass

An application for managing student advising information.

System Requirements

• Python (3.12)
• Docker
• Node

Development Stack

• Django (5.2)
• Vue (3.2)
• Vite (2.9)
• Vitest (0.10.2)

Design Stack

• Bootstrap (5.2)
• Bootstrap Icons (1.9.0)

Installation

Clone the repository

    $ git clone git@github.com:uw-it-aca/compass.git

Go to your working directory

    $ cd compass

Copy the sample .env file so that your environment can be run.

    $ cp .env.sample .env

Update any .env variables for local development purposes

Development (using Docker)

Docker/Docker Compose is used to containerize your local build environment and deploy it to an 'app' container which is exposed to your localhost so you can view your application. Docker Compose creates a 'devtools' container - which is used for local development. Changes made locally are automatically syncd to the 'app' container.

    $ docker-compose up --build

View your application using your specified port number in the .env file

    Demo: http://localhost:8000/

Access Group Admin: Copy Settings

In Django Admin, you can copy settings from one Access Group to another.

1. Open Django Admin and go to Access Groups.
2. Select exactly one target Access Group.
3. Choose the action Copy settings from another Access Group.
4. Pick the source Access Group and select which settings to copy.
5. Submit Copy.

Supported settings types:

• Affiliations
• Contact Types
• Contact Methods
• Contact Topics
• Eligibility Types
• Visit Types

Behavior notes:

• If a target record with the same name already exists, it is skipped.
• Slug uniqueness conflicts are reported as conflicts.
• The action shows a summary per setting type (created, skipped, conflicts).

Testing (using Vitest)

Run Vitest test scripts and generate coverage report

    $ npm run test
    $ npm run coverage

Linting (using ESLint and Stylelint)

Run ESLint for JS linting

    $ npm run eslint

Run Stylelint for CSS linting

     $ npm run stylelint