# Nextcloud — операторский минимум (чеклист)

Короткий порядок действий при любой заявке по Nextcloud.

## 0) Перед началом

- Подтвердить, что используется поддерживаемый браузер (Chrome/Firefox/Safari/Edge).
- Проверить доступы:
  - `NEXTCLOUD_URL`
  - `NEXTCLOUD_USER`
  - `NEXTCLOUD_TOKEN` (app password)

## 1) Определить тип проблемы

- Файлы (не видно, не грузится, не скачивается, нет места)
- Календарь/события
- Задачи
- Контакты
- Доступ/авторизация

## 2) Базовая диагностика по типу

### Файлы

1. Проверить наличие/путь:
   - `files list --path "/..."`
   - `files search --query "..."`
2. Если файл есть — проверить чтение:
   - `files get --path "/..."`
3. Если проблемы с загрузкой — тестовый upload в безопасный путь.
4. Если «нет места»:
   - проверить квоту
   - проверить Deleted files
   - проверить версии файлов

### Календарь

1. Проверить список календарей:
   - `calendars list --type events`
2. Проверить окно дат:
   - `calendar list --from "ISO" --to "ISO"`
3. Для правок всегда использовать точный `uid` из свежего списка.

### Задачи

1. Проверить список календарей задач:
   - `calendars list --type tasks`
2. Проверить список задач в нужном календаре:
   - `tasks list --calendar "..."`
3. Для правок/complete/delete — только по свежему `uid`.

### Контакты

1. Проверить адресные книги:
   - `addressbooks list`
2. Поиск контакта:
   - `contacts search --query "..."`
3. Правки/удаление — только по свежему `uid`.

### Доступ/авторизация

- 401/403: проверить пользователя и app password.
- 404: проверить точные имена календаря/адресной книги/пути.
- После ротации пароля пользователя — перевыпустить app password.

## 3) Правила безопасных изменений

1. Сначала `list/get/search`, потом `edit/delete`.
2. Не делать массовые изменения без теста на 1 объекте.
3. Для календаря всегда задавать явные `--start` и `--end` в ISO.
4. Фиксировать, что именно изменено: сущность, uid/id, время, результат.

## 4) Быстрый smoke-test после фикса

- Файлы: создать тестовый файл → прочитать → удалить.
- Календарь: создать короткое тест-событие → проверить в списке → удалить.
- Контакты: создать тест-контакт → найти → удалить.
- Задачи: создать тест-задачу → complete → удалить.

## 5) Команда запуска

```bash
node skills/openclaw-nextcloud/scripts/nextcloud.js <section> <command> [options]
```

Справка по разделам:
- `docs/Nextcloud_Work_Instructions.md`
- `docs/Nextcloud_Manual_Extract.md`