Tech DeskРабочее пространство
Единый кабинет проектов

Текущая роль: Владелец

О рабочем процессе Tech Desk

Как происходит коммуникация и для чего нужен Tech Desk

Tech Desk — рабочее пространство владельца проекта и технического специалиста. Задачи, решения, документация, история изменений и технический контекст находятся рядом с проектом, а не в разрозненных переписках и заметках.

Один рабочий процесс — одна проверяемая история

Статус задачи показывает текущую точку. Комментарии, запросы решений, история статусов, Activity и отчёты объясняют, как команда к ней пришла.

Работает
  1. Владелец

    Создаёт задачу и описывает ожидаемый результат.

  2. Назначение

    Технический специалист получает задачу в своём проектном контексте.

  3. В работе

    Исполнитель берёт задачу и фиксирует прогресс в статусе и комментариях.

  4. Вопрос

    Если продолжать без ответа нельзя — создаётся запрос решения владельца.

  5. Решение

    Владелец отвечает прямо в задаче; вопрос и ответ остаются в истории.

  6. Продолжение

    Технический специалист сам возвращает задачу в допустимый рабочий статус.

  7. Проверка

    Результат проходит согласованный переход на проверку или публикацию.

  8. Завершение

    Задача завершается или архивируется без потери контекста.

  9. История

    Activity, история статусов и отчёт строятся из сохранённых событий.

Владелец и технический специалист действуют в одной задаче, но система сохраняет их действия как отдельные факты проекта.

Коммуникационный слой проекта

Значимые договорённости не растворяются в потоке сообщений: они становятся частью структурированной истории.

Постановка задачиИсполнительСтатусКомментарииЗапрос решенияОтвет владельцаДокументацияActivityУведомленияОтчёты

Контекст остаётся с работой

Когда вопрос, ответ или изменение статуса относятся к задаче, они сохраняются рядом с ней и привязаны к проекту.

Посмотреть Activity

Рабочие разделы и их техническая основа

Каждый раздел объясняет действие простым языком и показывает, какие реальные модели и границы приложения его поддерживают.

Проекты

Работает

Каждый проект объединяет задачи, участников, документацию, события и отчётность.

Зачем это удобно
Рабочая информация не смешивается между проектами.
Технически
Project, ProjectMember, ActivityEvent и связи проекта в PostgreSQL через Prisma.
Открыть проекты

Задачи

Работает

Владелец ставит задачу, а технический специалист принимает её и ведёт до результата.

Зачем это удобно
Договорённости и критерии готовности остаются рядом с работой.
Технически
Task, ключ задачи в проекте, TaskStatusHistory, state machine и application use cases.
Открыть задачи

Нужно решение

Работает

Когда без владельца нельзя продолжать, специалист формулирует вопрос в самой задаче.

Зачем это удобно
Решение не теряется в переписке и не подменяет технический статус задачи.
Технически
DecisionRequest с авторами, временем, историей ответов, ActivityEvent и AuditLog.
Открыть обзор

Активность

Работает

Журнал показывает, что, кем и когда было сделано по проекту или задаче.

Зачем это удобно
Проект можно восстановить по фактам, а не по памяти участников.
Технически
Append-only ActivityEvent, фильтры по проекту, периоду, типу, участнику и поиску.
Посмотреть Activity

Документация

Работает

Внутренние инструкции, решения и технические заметки читаются в единой базе знаний.

Зачем это удобно
Технический контекст проекта остаётся доступным рядом с задачами.
Технически
Document, категории, проектный доступ, поиск и безопасный Markdown-просмотр без небезопасного HTML.
Открыть документацию

Отчёты

Работает

Сводка показывает сохранённые факты рабочего процесса за выбранный период.

Зачем это удобно
Вместо ручного сбора статусов можно показать завершённые работы и активность.
Технически
TaskStatusHistory, ActivityEvent, DecisionRequest и resolveReportRange для периодов.
Посмотреть отчёты

Уведомления

Работает

Участник видит значимые действия другого участника прямо в Tech Desk.

Зачем это удобно
Назначение, комментарий и решение не требуют отдельного канала связи.
Технически
Notification, read state, polling MVP и защита от self-notifications в domain/application layer.
Открыть обзор

Интеграции

Подключается

Техническая документация репозитория будет читаться в том же интерфейсе.

Зачем это удобно
GitHub остаётся источником истины, а Tech Desk — местом чтения и поиска.
Технически
ProjectRepository, RepositoryDocument index, закреплённый commit SHA и server-only GitHub App boundary.
Открыть GitHub-документы

Документация в двух источниках

Внутренние рабочие материалы и техническая документация репозитория имеют разное назначение, но читаются в одном интерфейсе.

Работает

INTERNAL · внутренняя база знаний

Инструкции, регламенты, решения и заметки создаются внутри Tech Desk, привязываются к проекту и находятся через поиск и категории.

Реализовано: Document, проектный доступ, автор/редактор, поиск, категории и безопасный Markdown-просмотр.

Открыть внутренние документы
Подключается

GITHUB · документация рядом с кодом

GitHub остаётся источником истины. Tech Desk индексирует разрешённые Markdown-файлы и читает их по закреплённому commit SHA, не создавая вторую версию документа.

GitHub repository → GitHub App только для чтения → сканер Markdown → RepositoryDocument metadata → закреплённый commit SHA → безопасный Markdown-просмотр

Код синхронизации и reader уже подготовлены; для фактического чтения требуется настройка GitHub App и установка для репозитория.

Открыть GitHub-документы

Архитектура сохраняет границы

Интерфейс не является единственным местом проверки правил: use cases координируют доменные записи, Activity и AuditLog.

Next.js App Router→application services→domain rules→Prisma→PostgreSQL

Task state machine, permissions, project scope, notification guard и GitHub boundary не зависят от конкретного экрана.

Что можно развивать дальше

Следующий шаг выбирается после изучения реальной инфраструктуры проекта, а не добавляется «на всякий случай».

Можно добавить
  • GitHub / GitLab и факты из репозитория
  • VDS, Docker и systemd
  • PostgreSQL, другие базы данных и backup-процессы
  • CI/CD, мониторинг и логи
  • CRM, n8n, Telegram и API обучающей платформы

Hermes / AI — будущий agent layer

Не чат-бот с произвольным доступом, а слой, который работает только с разрешённым контекстом и действиями.

Можно добавить
Tech Desk→permissions/context layer→Agent Gateway→Hermes→разрешённые данные и действия

AI-агент не получает прямой доступ к PostgreSQL, GitHub private key или другим секретам.

Будущие запросы к контексту проекта

  • «Что изменилось за неделю?»
  • «Что сейчас заблокировано?»
  • «Какие решения ожидаются от владельца?»
  • «Найди документацию по deployment.»
  • «Подготовь технический отчёт за день.»
  • «Создай задачу по голосовому сообщению.»

Текущая версия — основа для настоящего рабочего процесса

Tech Desk развивается вокруг задач, решений и инфраструктуры конкретного проекта. Уже реализованные сценарии можно открыть и показать в рабочем интерфейсе.