# Office Lab

> Совместная работа с Office в стиле GitHub: требования, Issue, PR, нативная проверка, прототипы и планирование в одном Repo Workspace.

- Human documentation: [https://docs.univer.ai/ru-RU/overview/examples/office-lab](https://docs.univer.ai/ru-RU/overview/examples/office-lab)

- Agent Markdown: [https://docs.univer.ai/ru-RU/overview/examples/office-lab.md](https://docs.univer.ai/ru-RU/overview/examples/office-lab.md)

- Requested language: `ru-RU`

- Content language: `ru-RU`

- Documentation version: `1.3.0`

- Source: [examples/office-lab.ru-RU.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/examples/office-lab.ru-RU.mdx)

---

**Office Lab** переносит процесс работы с репозиториями на продуктовые задачи. На основе **[Univer Office SDK](https://docs.univer.ai/ru-RU/overview.md)** и Repo-режима Workspace он объединяет документы, таблицы, интерактивные прототипы, Issue и pull request. Команда видит запрос, изменения и готовый результат в одном проекте.

Продакт-менеджер и инженер готовят и проверяют материалы с привычными агентами. Люди обсуждают поведение, рассматривают изменения и решают, что передать в общую работу.

[Один проект, два взгляда](#case-study) · [Превратите находку в конкретную Issue](#issues) · [Проверяйте содержимое с Worktree и Compare](#review) · [Создавайте, публикуйте и организуйте Web App](#web-apps) · [Попробуйте Office Lab](#quick-start)

Снимки сделаны в настоящем [облачном Workspace](https://space.univer.ai) с вымышленными английскими данными. Два названных агента — предложенная организация работы.

## Один проект, два взгляда

**Team Invitations** — небольшой сценарий приглашения коллеги с выбором роли и понятным результатом. Повторное приглашение ожидающего адреса связывает улучшение прототипа, критерии приёмки, аналитику и расписание.

| Роль | Пример агента | Вклад |
| --- | --- | --- |
| Maya · Продукт | Codex | Опыт, требования, приёмка, аналитика и проверка. |
| Alex · Разработка | Claude Code | Изучение прототипа, Issue, изменения и проверка поведения. |

| Материал | Назначение |
| --- | --- |
| Product brief · Doc | Цель, правила приглашения, приёмка и условия выпуска. |
| Tracking plan · Doc | Триггеры, свойства и правила измерения. |
| Event catalog · Sheet | События, ответственные и готовность. |
| Delivery schedule · Sheet | Задачи, владельцы, даты, прогресс и оценки. |
| Invite Prototype / Team Access Console · Web App | Интерактивная форма приглашения. |

```mermaid
flowchart TD
A["Issue"]
B["Maya · Продукт"]
C["Alex · Разработка"]
D["Office Worktree"]
E["PR + Compare"]
F["Общие материалы Office"]
G["Web App"]
H["Pages"]
A --> B --> D --> E --> F
A --> C --> D
C --> G --> H
E -->|Issue| A
```

## Просмотр Repo и материалов проекта

Откройте командный Space в Repo-режиме. **Code** объединяет редактируемые документы и файлы приложения с поиском и предпросмотром. Issues, Pull requests, Pages и Settings находятся рядом с материалами проекта.

Repo — другое представление того же Space, сохраняющее содержимое и права. Выбранную Web App можно показать на главной странице проекта и сразу попробовать.

![Просмотр Repo и материалов проекта](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/examples/office-lab/cloud-repository-rich.png)

## Превратите находку в конкретную Issue

Alex создаёт **Prevent duplicate invitations**, описывая ожидаемое сообщение, событие блокировки и дополнительную QA-проверку. Связанные файлы соединяют требования, аналитику, каталог и расписание.

Описание, комментарии, ответственные и метки уточняют следующее действие. Issue доступны в командных Spaces; агент читает ту же задачу через Workspace CLI. Обратная связь остаётся в Issue или комментариях к документу.

![Превратите находку в конкретную Issue](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/examples/office-lab/cloud-issue.png)

## Предложите изменения через PR

PR представляет Worktree Workspace как предложение для проверки. Создайте черновик, добавьте существующие документы, измените и пометьте Ready. Доступны название, описание, автор, состояние и список файлов; общие материалы остаются доступными.

На снимке PR добавляет `invite_duplicate_blocked` в каталог и меняет QA-расписание, ссылаясь на Issue #1. Каждый участник работает в своём черновике и открывает его разрешённым проверяющим, сверяясь с общими источниками.

![Предложите изменения через PR](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/examples/office-lab/cloud-pull-request.png)

## Проверяйте содержимое с Worktree и Compare

Из описания перейдите в **Files changed**. **View** показывает результат только для чтения; **Compare** сопоставляет официальную и предлагаемую версии со списком переходов к изменениям. События, ответственные и даты видны в нативном Office-контексте.

[Worktree](https://docs.univer.ai/ru-RU/overview/features/shared/worktree.md) изолирует задачу, а [Compare](https://docs.univer.ai/ru-RU/overview/features/shared/compare.md) использует модель содержимого, Snapshot и Changeset. Человек с нужными правами запрашивает правки или подтверждает слияние. Показанный PR двух файлов остаётся Ready и не слит.

![Проверяйте содержимое с Worktree и Compare](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/examples/office-lab/cloud-compare.png)

### Проверьте влияние на сроки

Тот же PR переносит завершение Usability and QA с 9 на 10 ноября и увеличивает оценку с двух до трёх дней. Проверьте ответственного, даты и состояние вместе с событием, учитывая необходимую работу при приёмке.

![Проверьте влияние на сроки](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/examples/office-lab/cloud-schedule.png)

## Создавайте, публикуйте и организуйте Web App

В **Pages** можно найти опубликованные Web Apps, открыть страницу, скопировать адрес и выбрать предпросмотр главной страницы. Выбор страницы по умолчанию действует только в текущем браузере; файлы и доступ управляются Workspace.

Прототип приглашения расширен до **Team Access Console**: список участников и ролей, фильтры статуса, поиск, приглашение и отмена, недавние действия, критерии приёмки и счётчики событий сессии на одной странице. Новый тестовый адрес обновляет список и число ожидающих приглашений; повторные приглашения блокируются. Данные остаются в памяти: письма и аналитические события не отправляются. Продакт-менеджер может проверить поведение и создать Issue по найденной проблеме.

Изменения Office проходят проверку и слияние Worktree, а HTML View — отдельный процесс сохранения и разрешения публикации. Прототип опубликован отдельно от ожидающего документного PR. Для живых Office-данных смотрите экспериментальный [Binding](https://docs.univer.ai/ru-RU/overview/features/shared/binding.md).

[Попробовать интерактивный прототип](/assets/examples/office-lab/invite-prototype.univer.html)

![Team Access Console: участники, приглашения и проверка](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/examples/office-lab/cloud-team-access.png)

## Определите границы совместной работы

**Settings** объединяет название, описание, видимость, участников и корзину. Владельцы и администраторы организуют доступ; редактирование, проверка и слияние зависят от действующих прав пользователя.

Продукт проверяет опыт и приёмку, разработка — реализацию и аналитику. Уполномоченный человек сливает Office-изменения, проверяет опубликованный прототип и закрывает Issue после завершения.

![Определите границы совместной работы](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/examples/office-lab/cloud-settings.png)

## Попробуйте Office Lab

1. Войдите в [облачный Workspace](https://space.univer.ai) или откройте [своё развёртывание](https://docs.univer.ai/ru-RU/overview/examples/workspace.md#self-host). Создайте или откройте **командный Space**.
2. Откройте **Application settings → Page theme → Repository (experimental)**. Это другой вид того же Space; выбор сохраняется только в текущем браузере.
3. Просматривайте документы в **Code**, отслеживайте задачи в **Issues**, проверяйте изменения в **Pull requests** и открывайте опубликованные Web App в **Pages**.

![Переключение командного Space в режим Repository и просмотр документов, Issue, PR и Web App](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/examples/office-lab/cloud-office-lab-tour.gif)

Чтобы работать со своим агентом, выполните [настройку Workspace CLI](https://docs.univer.ai/ru-RU/overview/examples/workspace.md#cli-start). Каждый агент использует разрешённый аккаунт своего пользователя. Следующие задания помогут воспроизвести сценарий.

### 1. Продукт: общий контекст

```text
В командном Space Team Invitations подготовь английские требования, план аналитики, каталог событий, расписание и предпросмотр Web App приглашений. Укажи ответственных, даты и приёмку. Оставь Office-изменения в Worktree, проверь и верни ссылки на проверку. Жди моего разрешения на слияние и публикацию прототипа.
```

### 2. Разработка: конкретное улучшение

```text
Прочитай требования, события, расписание и прототип. Проверь повторные ожидающие приглашения и создай Issue с шагами и ожидаемым результатом. Подготовь Office-правки в отдельном Worktree, а прототип — через его процесс публикации. Проверь результат, укажи Issue в описании PR и жди проверки человеком.
```

### 3. Проверка: изменения и критерии приёмки

```text
Проверь PR через Compare: событие блокировки, приёмку и QA-расписание; попробуй прототип. Запиши недочёты в Issue и попроси автора исправить. Раздели готовое и ожидающее в отчёте. Не сливай и не публикуй без моего согласия.
```

## Используйте те же SDK и Skills

Оба агента используют согласованные с версией CLI Skills: `core` для поиска и Worktree, `doc` и `sheet` для требований и планов, `html-view` для прототипа. Агенты читают доступные материалы друг друга и отзывы Issue, а люди принимают окончательное решение.

Web SDK даёт модели, редакторы и Headless; Server SDK — совместную работу, версии и Worktree; AI SDK — операции и проверку. Workspace собирает проект, идентификацию, Issue, Repo и публикацию. Эту композицию можно превратить в собственную продуктовую лабораторию или внутреннюю рабочую среду.

[О Workspace](https://docs.univer.ai/ru-RU/overview/examples/workspace.md) · [Исходный код](https://github.com/dream-num/univer-workspace) · [Все примеры](https://docs.univer.ai/ru-RU/overview/examples.md)