MireaFrontend/README.md

106 lines
3.4 KiB
Markdown
Raw Normal View History

2024-06-28 22:45:19 +03:00
# MIREA schedule by Winsomnia
2024-02-05 06:29:18 +03:00
2024-07-13 00:17:49 +03:00
[![Angular Release](https://img.shields.io/badge/v18.1-8?style=flat-square&label=Angular&labelColor=512BD4&color=606060)](https://github.com/angular/angular-cli)
2024-06-28 22:45:19 +03:00
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
This project provides a Web interface for working with the MIREA schedule.
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
The main task is to provide a convenient and flexible interface for accessing the schedule via a web browser.
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
## Purpose
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
The purpose of this project is designed to provide a user-friendly web interface for working with the schedule of training sessions of the Moscow Technological University (MIREA).
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
In a situation where existing resources provide limited functionality or an inconvenient interface, this project aims to provide users with a simple and effective interface for accessing information about the class schedule.
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
Developing your own components and communicating with the schedule API allows you to provide flexibility, extensibility and usability of the application.
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
## Features
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
- View the schedule.
- Select data by professor, by group and other criteria.
- Use the convenient setup wizard (Wizard Installation) to configure the Backend via a Web browser.
- Administer the site through the built-in tools.
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
## Project status
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
The project is under development. Further development will be aimed at expanding the functionality and improving the user experience.
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
# Environment Variables
2024-02-05 06:29:18 +03:00
2024-06-28 22:45:19 +03:00
Before starting the project, you need to fill in your data in the [`environment.ts`](src/environments/environment.ts) file.
| Variable | Example | Description |
|------------|----------------------------------|----------------------------------------------------|
| apiUrl | https://mirea.winsomnia.net/api/ | Provides an address for accessing the API |
| maxRetry | 5 | The number of attempts in case of a failed attempt |
| retryDelay | 3000 | How long should wait in ms before the next attempt |
# Installation
If you want to make a fork of this project or place the Web application on your hosting yourself, then follow the instructions below.
To install using a pre-built application, follow these steps:
1. [Install Node.js](#install-nodejs)
2. [Clone Git](#clone-git)
3. [Install dependency](#install-dependency)
4. Serve or build static files
* [Serve](#serve)
* [Build](#build)
### Install Node.js
Install Node.js for further work or building the application. Go to the [official website Node.js](https://nodejs.org/en/download/package-manager ) and select the required packages.
### Clone Git
Clone the repository
```bash
git clone https://git.winsomnia.net/Winsomnia/MireaFrontend.git
```
Go to the project directory:
```bash
cd MireaFrontend
```
### Install dependency
Install the necessary dependencies. You can use npm or pnpm:
```bash
npm install
```
### Serve
Launch the application using:
```bash
ng serve
```
The application will be available at http://localhost:4200.
### Build
Run the build of the project using:
```bash
ng build
```
The project files will be in the following directory: `dist/frontend`
# Contribution and Feedback
You can contribute to the project by creating pull requests. Any feedback is welcome to improve the project.
# License
This project is licensed under the [MIT License](LICENSE.txt).