mse1h2026-table

Требования

Перед началом убедитесь, что установлены:

• Docker и Docker Compose
• Python 3.x
• Git

---

Необходимые настройки

Добавьте запись в файл /etc/hosts (требуется один раз):

127.0.0.1   nextcloud.local

На Linux/macOS это можно сделать командой:

echo "127.0.0.1   nextcloud.local" | sudo tee -a /etc/hosts

---

Установка и запуск

1. Склонируйте репозиторий и перейдите в него:

git clone https://github.com/moevm/mse1h2026-table.git
cd mse1h2026-table

2. Перейдите в папку table/ — все дальнейшие команды manage.py выполняются отсюда:

cd table

3. Запустить систему:

   python manage.py deploy up

Или напрямую через Docker Compose (из папки deploy/):

   cd deploy
   docker compose up -d

4. После запуска Nextcloud (с подключённым OnlyOffice) доступен по адресу: http://nextcloud.local:8080

   При необходимости порт можно изменить через переменную NEXTCLOUD_PORT в файле deploy/.env.

5. Дождаться полной готовности системы:

python manage.py deploy status --wait

6. Наполнить систему тестовыми данными:

   python manage.py deploy demo

7. Для остановки:

python manage.py deploy down

Или напрямую через Docker Compose (из папки deploy/):

cd deploy
docker compose down

---

Интеграция Nextcloud Forms → Windmill → Таблицы

Инструкция по настройке OAuth-подключения, созданию workflow для отправки форм и проверке интеграции - на вики странице Интеграция Windmill .

---

Работа с пользователями Nextcloud через manage.py

Все команды выполняются из папки table/:

cd table

Просмотр пользователей

• Показать всех пользователей (только логины):

  python manage.py users list

• Показать всех пользователей с подробностями (email, группы, квота):

  python manage.py users list --details
  

Фильтрация пользователей

Для гибкой фильтрации используйте флаг --filter <поле> <режим> <значение>. Можно указывать несколько фильтров подряд.

• По username (начинается с 'adm'):

  python manage.py users list --filter username prefix adm
  

• По email (содержит 'example.com'):

  python manage.py users list --filter email contains example.com --details
  

• По группе (точное совпадение 'admin'):

  python manage.py users list --filter group exact admin --details
  

• Комбинированные фильтры:

  python manage.py users list --filter username prefix adm --filter email contains mail.ru --details
  

Описание фильтров

• <поле>: username, email, group

• <режим>: contains (содержит), prefix (начинается с), exact (точное совпадение)

• <значение>: строка для поиска

• Для просмотра email, групп и квоты используйте флаг --details.

• Флаг --prefix также работает для фильтрации по началу username.

Создание и удаление пользователей

• Создать одного пользователя:

  python manage.py users create <username> --email <email> --display-name <name> --user-password <password> --quota 1GB --groups <group>

• Удалить одного пользователя:

  python manage.py users delete <username>

• Создать пользователей из CSV:

  python manage.py users csv-create <path/to/file.csv>

• Удалить пользователей из CSV:

  python manage.py users csv-delete <path/to/file.csv>

Загрузка таблиц

• Загрузить один файл:

  python manage.py upload --file <path/to/file.xlsx> --dest /папка --name "Название"

• Загрузить все файлы из директории:

  python manage.py upload --dir <path/to/dir> --dest /папка

Мониторинг и статус

• Проверить статус всех компонентов системы:

  python manage.py deploy status

• Ждать полной готовности системы:

  python manage.py deploy status --wait

• Посмотреть метрики ресурсов (CPU, RAM, диск):

  python manage.py monitor resources