Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@

### Добавлено

- **План недельного отчёта:** добавлен JTBD PM-09 и OpenSpec `add-weekly-task-report` для четырёх показателей по всему выбранному проекту с optional фильтром ответственного. Определены календарная неделя, текущие контроль/работа, REST1 read route и partial results; команда ещё не реализована. [#168](https://github.com/mesilov/bitrix24-cli/issues/168).

- **Передача задач проекта:** `task:handover --group-id ID --responsible ID` передаёт все доступные незавершённые задачи текущего пользователя другому участнику; `--from ID` позволяет руководителю передать работу между двумя сотрудниками. Проверяются членство, полная выборка (включая точную границу бюджета) и результат каждого назначения; dry-run и отчёт сохраняют частичные/неизвестные исходы без автоматического повтора. Добавлен EMP-09, уточнён PM-04. [#162](https://github.com/mesilov/bitrix24-cli/issues/162)

- **Шаблоны задач:** `task:template:show`, `task:template:fields:list`, `task:template:add/update/delete` через REST 1.0 с нативными полями, JSON/plain и dry-run. Добавлен JTBD PM-08; неоднозначное подтверждение удаления отражается как partial (exit 3), доступность после запроса видна в JSON/human/plain. [#72](https://github.com/mesilov/bitrix24-cli/issues/72)
Expand Down
25 changes: 23 additions & 2 deletions docs/task-jtbd.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@

Сверка [#136](https://github.com/mesilov/bitrix24-cli/issues/136) от 14.10.2026: runtime SHA `f8c380a4539d78556c97655f122a9ba52c1651c8`, база `dev` — `5330662`. Для PM-02/AM-03 длительности представлены в seconds/hours/days с исключением субботы и воскресенья по серверному offset; приёмка #121 подтверждена и завершена. Число сценариев и их ID сохранены.

**24 сценария:** 8 для руководителя отдела, 7 для аккаунт-менеджера проекта, 9 для рядового исполнителя. Исходные 22 сценария: ситуация, работа, цель и признак успеха взяты из [канонической спецификации task-workflows](../openspec/specs/task-workflows/spec.md); ID сохранены для трассировки на команды и тесты.
**25 сценариев:** 9 для руководителя отдела, 7 для аккаунт-менеджера проекта, 9 для рядового исполнителя. Исходные 22 сценария: ситуация, работа, цель и признак успеха взяты из [канонической спецификации task-workflows](../openspec/specs/task-workflows/spec.md); ID сохранены для трассировки на команды и тесты. Новый PM-09 пока задан в delta [add-weekly-task-report](../openspec/changes/add-weekly-task-report/specs/task-workflows/spec.md) и имеет статус «План».

Группировка «руководитель отдела» соответствует исходной роли «Руководитель проекта» (`PM-*`), «аккаунт-менеджер проекта» — «Аккаунт менеджер» (`AM-*`), «рядовой исполнитель» — «Сотрудник» (`EMP-*`). В группе PM приведены согласованные сценарии управления проектной работой; отдельные сценарии управления отделом пока не специфицированы. Эта группировка не меняет исходные требования и не предоставляет прав в Битрикс24: действия зависят от текущего подключения.

Expand All @@ -23,9 +23,11 @@

Сверка [#170](https://github.com/mesilov/bitrix24-cli/issues/170) от 16.10.2026, база dev `0caf9db`: проверка состава EMP-09/PM-04 использует фактический scope `sonet_group`. Серверный сброс статуса в `pending` после назначения обрабатывается достижением явной цели либо восстановлением исходного статуса штатными действиями. Повторная live-матрица: 18/18 проверок PASS; 4/4 integration tests PASS, включая ожидаемые partial/отказы. [Evidence и ограничения](../openspec/changes/archive/2026-10-16-fix-task-handover-project-scope/live-acceptance.md). Существующие 24 JTBD и ID сохранены.

Сверка планирования от 16.10.2026, база `dev` — `0caf9db62fce3f91852aafc77fd9b25cb3f9bde2`: добавлен PM-09 «Недельный отчёт». По умолчанию выбранный проект целиком, optional `--responsible` сужает все четыре показателя. Команда `task:report` не реализована; каталог сохраняет 49 task-команд / 63 публичных. [Постановка и состояние GitHub issue](../openspec/changes/add-weekly-task-report/proposal.md#github-issues).

## Роли

- **[Руководитель отдела](#role-manager)** — организует работу команды: планирует этапы, следит за рисками, снимает препятствия, пересогласует сроки и распределение работ, принимает результат внутри команды. Сценарии `PM-01`…`PM-08` описывают управление проектной работой и её координацию.
- **[Руководитель отдела](#role-manager)** — организует работу команды: планирует этапы, следит за рисками, снимает препятствия, пересогласует сроки и распределение работ, принимает результат внутри команды. Сценарии `PM-01`…`PM-09` описывают управление проектной работой и её координацию, включая [недельный отчёт](#pm-09).
- **[Аккаунт-менеджер проекта](#role-account-manager)** — связывает клиента и команду: передаёт запросы, следит за обещаниями, сообщает о ходе работ, согласует изменения требований и передаёт результат с обратной связью клиента. Сценарии `AM-01`…`AM-07`.
- **[Рядовой исполнитель](#role-executor)** — выполняет задачи: выбирает следующую работу, получает контекст, запрашивает помощь, учитывает актуальные ожидания, предъявляет результат и фиксирует трудозатраты. Сценарии `EMP-01`…`EMP-09`.

Expand Down Expand Up @@ -193,6 +195,23 @@

**Границы:** операции REST 1.0 зависят от прав подключения и недоступны в strict-rest3. Delete=false даёт exit 3 и confirmed=false; последующее отсутствие видимости не доказывает удаление. Пять отдельных integration tests подготовлены; наличие файлов тестов не подтверждает live-приёмку. Список шаблонов, запуск задачи из шаблона, расписания и чек-листы не входят в поставку. [Ввод полей и форматы](task-usage.md#шаблоны-задач).

<a id="pm-09"></a>

### [PM-09](../openspec/changes/add-weekly-task-report/specs/task-workflows/spec.md) — Недельный отчёт

- **Когда:** подвожу итоги недели выбранного проекта.
- **Хочу:** получить список закрытых задач, список задач на контроле, количество новых задач и количество задач в работе.
- **Чтобы:** оценить выполненную работу, очередь приёмки и текущую нагрузку.
- **Признак успеха:** четыре показателя проверяемы; указаны период, timezone, область доступа и полнота. По умолчанию весь выбранный проект; фильтр конкретного ответственного сужает все четыре показателя.

| Статус | Команда | Тест |
| --- | --- | --- |
| 🕓 План | `task:report --group-id ID [--responsible ID] [--week this-week\|last-week\|YYYY-MM-DD] [--timezone IANA]` | Нет; будущие проверки перечислены в [tasks.md](../openspec/changes/add-weekly-task-report/tasks.md) |

**Состав:** закрытые имеют текущий completed и фактическую closedDate в выбранной неделе; новые считаются по createdDate за неделю. Контроль — текущий supposedly_completed, работа — текущее количество in_progress независимо от недели создания. Неделя с понедельника, по умолчанию last-week; --responsible означает текущего ответственного, а не автора задачи.

**Границы:** это постановка для 0.3.0, команда отсутствует в runtime. Два текущих показателя относятся к чтению при формировании отчёта, даже для прошлой недели; исторический/атомарный snapshot не обещается. Повторно открытая задача не входит в закрытые. Доступная выборка отделена от всего проекта; partial требует неизвестного точного count и exit 3. Подробности — в [спецификации отчёта](../openspec/changes/add-weekly-task-report/specs/task-weekly-report/spec.md). Unit/integration/live-приёмка команды ещё не выполнена.

<a id="role-account-manager"></a>

## Аккаунт-менеджер проекта
Expand Down Expand Up @@ -245,6 +264,8 @@
- **Чтобы:** дать обоснованный ответ без опроса каждого исполнителя.
- **Признак успеха:** Есть проверяемая сводка: сделано, осталось, что мешает, когда следующее обновление.

Планируемый недельный срез с четырьмя показателями определён в [PM-09](#pm-09). Он не подтверждает готовность всей клиентской сводки AM-03.

**Команды и интеграционные тесты**

| Статус | Команда | Тест |
Expand Down
2 changes: 2 additions & 0 deletions openspec/changes/add-weekly-task-report/.openspec.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-10-16
Loading
Loading