An open API service indexing awesome lists of open source software.

https://github.com/secs-dev/dbms-course

Repository for the ITMO CSE DBSM course.
https://github.com/secs-dev/dbms-course

Last synced: 4 months ago
JSON representation

Repository for the ITMO CSE DBSM course.

Awesome Lists containing this project

README

          

# Системы управления базами данных

Данный репозиторий содержит дополнительные материалы для курсов БД и РСХД.

Если вы защищаете ЛР, то автоматически считается, что вы приняли
[норму поведения](./CODE_OF_CONDUCT.md).

## Лабораторные работы по РСХД

1. [Конфигурация PostgreSQL](./advanced-lab-1-pg-configuration/)

2. [Резервное копирование PostgreSQL](./advanced-lab-2-pg-backup/)

3. [Репликация в PostgreSQL](./advanced-lab-3-pg-replication/)

## Порядок выполнения и сдачи ЛР

> [!WARNING]
> При невыполнении одного из требований из порядка выполнения и сдачи
> ЛР преподаватель вправе отказать вам в приеме. Отнеситесь к ним серьезно, эти
> правила необходимы для снижения ментальной нагрузки на преподавателя c целью
> повышения эффективности его работы.

Данный порядок выполнения и сдачи ЛР дополняет требования на сайте курса на
. При наличии конфликтов требования этого документа и
, приоритет отдается требованию с .

### Шаг 1. Создание репозитория

Создайте приватный репозиторий, используя данный в качестве шаблона.
`Use this template -> Create Repository`.

Установите требуемое название, описание и доступность.

- Repository name: `dbms-course`.

- Description: `Student: P1111 Ivan Ivanov.`.

- Choose visibility: `Private`.

Выдайте преподавателю практики доступ на чтение вашего репозитория.
`Settings -> Collaborators and teams -> Add people`.

## Шаг 2. Выполнение задания

Для каждой ЛР выделена отдельная директория c именем `xxxxx`.

1. Откройте корневую директорию данного репозитория в IDE.

2. Отведите ветку от `main`. Ветка должна называться `xxxxx`.

3. Напишите код, сохраняя по возможности детальную историю коммитов.
Исходный код рекомендуется разместить в директории `xxxxx/source`.

4. Напишите отчет в соответствии с требованиями в "Приложении Б".
Исходный код и ресурсы для отчета рекомендуется разместить в
директории `xxxxx/report`. Для составления отчета рекомендуется
использовать [Typst](https://github.com/typst/typst).

5. Выгрузите коммиты в удаленный репозиторий.

6. Создайте Pull Request (PR) из `xxxxx` в `main`, согласно
требованиям к оформлению из "Приложения А".

7. Пройдите автоматические проверки. Они проверят качество и валидность
произведенных вами артефактов. Ознакомьтесь с ними в
[.github/workflows/style.yml](./.github/workflows/style.yml).

> [!TIP]
> Возможно, вы будете не согласны с некоторыми ошибками линтера.
> Очевидно странные проверки вы можете отключить, но в комментариях
> к PR-у необходимо аргументировать свое решение.

## Шаг 3. Прохождение (опционального) ревью кода

1. Дайте преподавателю практики право на просмотр и ревью вашего рерпозитория.
Когда задание будет выполнено, назначьте его ревьювером и упомяните в
обсуждении PR.

2. Исправьте замечания.

3. Получите ОК от преподавателя и дополнительное задание.

4. Выполните дополнительное задание.

> [!NOTE]
> Данный этап является опциональным. Ревью является возможностью
> получить раннюю обратную связь, но преподаватель не обязан делать ревью.

## Шаг 4. Защита лабораторной работы

1. Отправьте отчет преподавателю на почту. Тема письма должна совпадать с
заголовком PRа. Содержимое письма должна совпадать с описанием PRа.

2. Приходите на занятие готовыми ответить на вопросы и продемонстрировать
работу. Больше требований к защите на странице курса на
.

3. Пройдите защиту.

4. Получите частичную оценку и вариант на следующую ЛР.

5. Получите дополнительное задание на текущую ЛР. Выполнение дополнительного
задания не блокирует получение варианта на следующую ЛР, но блокирует ее
защиту.

## Приложение А. Формат описания Pull Request (PR)

Title: `ЛР[1-4] (<Группа> <Фамилия> <Имя>)+`

```text
<Название ЛР>
Вариант: <Вариант ЛР>
Преподаватель: <Фамилия> <Имя> <Отчество>

## Описание изменений

<Описание изменений>
```

## Приложение Б. Общие требования к отчету

1. Имя файла совпадает с заголовком PRа.

2. Титульный лист cодержит:

1. Организация

2. Факультет

3. Наименование работы. В том числе номер и название

4. ФИО студента полностью

5. Группа

6. ФИО преподавателя практики полностью

7. Год

3. Ссылка в начале секции "Ход работы".

4. Промежуточные результаты выполнения основного и дополнительного заданий.

5. Заключение.