STES - Student Task Evaluation System

This project was generated using Angular CLI version 19.2.9.

Development server

To start a local development server using Docker, run:

docker compose up --build

For future runs, use:

docker compose up -d

Once the server is running, open your browser and navigate to http://localhost:4200/. The application will automatically reload whenever you modify any of the source files.

---

Utilities Script (utils.sh)

The utils.sh script contains several utility commands to assist with managing Git hooks, Docker, and automated tasks. It provides commands to simplify the workflow during the development process.

Available Commands

Command	Description
install	Copies Git hooks from ./githooks to .git/hooks and builds Docker images.
copy-hooks	Copies Git hooks from ./githooks to .git/hooks and makes them executable.
build-docker	Builds Docker images using docker compose build.
up	Starts Docker containers in detached mode (docker compose up -d).
down	Stops and removes Docker containers (docker compose down).
e2e	Runs end-to-end Cypress tests using Docker (docker compose run cypress).
help	Displays a list of all available commands and their descriptions.

Flag --no-backend does not trigger build/up on backend.

Using utils.sh

To use the utils.sh script, ensure it is executable by running:

chmod +x utils.sh

Then, you can run any of the available commands. Examples:

1. Prepare Development Environment

This command copies Git hooks and builds Docker images:

./utils.sh install

2. Manage Docker Containers

• Start containers:

  ./utils.sh up

• Stop and remove containers:

  ./utils.sh down

3. Run End-to-End Tests

Run Cypress end-to-end tests using Docker:

./utils.sh e2e

---

Code scaffolding

Angular CLI includes powerful code scaffolding tools. To generate a new component, run:

ng generate component component-name

For a complete list of available schematics (such as components, directives, or pipes), run:

ng generate --help

---

Building

To build the project, run:

ng build

This will compile your project and store the build artifacts in the dist/ directory. By default, the production build optimizes your application for performance and speed.

---

Running unit tests

To execute unit tests with the Karma test runner, use the following command:

ng test

---

Running end-to-end tests

To run Cypress tests using Docker, use:

docker compose run cypress

Alternatively, you can use the utils.sh script:

./utils.sh e2e

---

Additional Resources

For more information on using the Angular CLI, including detailed command references, visit the Angular CLI Overview and Command Reference page.