89 lines
3.6 KiB
Markdown
89 lines
3.6 KiB
Markdown
# 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`
|