Этап
Открыта
Тип
Задача
Приоритет
Повышенный
Трудоемкость
Сложная
Создана
Дата создания
4 года назад
Назначена
Обновлена
8 месяцев назад

Это не справочник, а отдельная сущность.

Участвуют и в документах и в задачах, и там и там опционально. Это позволит использовать категории

  • для описания подсистем, имеющих документацию и задачи
  • для описания чисто документальных подразделов и частей, например (мысли, идеи на будущее, документация, исследования)
  • для описания меток для задач. (вот это идеологически кажется не верным, если часть задач объединяется категорией, то хорошо бы такую большую работу задокументировать, а если это разовая штука, то объединяться она должна эпиком, а не категорией)

Базовые поля

  • Имя
  • slug как транслитерация имени
  • Описание
  • флаг используется в задачах
  • флаг используется в документах подумать, может быть категории всегда использовать в документах
  • docId - ссылка на документ описывающий категорию возможно отдельной задачей, где будет проработано где ссылка на категорию приведет к нему, а где на список ассоциированных с категорией задач и документов

В будующем, в tndt-199 будет организовано дерево категорий

CRUD. (D в виде soft delete) Контролы назначения категории задачам и документам.

Если все будет быстро, сразу добавить в список документов подумать о фильтрации по категории, благо tndt-19 готова.

В side-menu вместо списка документов, выводить категории первого уровня, и в нем список документов с выставленным фильтром по категории. вот это врядли, пока что у нас в каждой категории будет очень мало документов, чаще всего по одному документу на систему. Поэтому пункт “Все документы” еще очень долго будет актуальна. Скорее в будущем сделать отдельную страницу категории, где в одном блоке будет список документов, а рядом асоциированных с ней задач. И это будет параллельно общему списку документов.

Панель управления

Комментарии могут оставлять только авторизованные пользователи
 demius 8 месяцев назад

Очень не хватает нам хотя бы минимлаьных категорий, чтобы искать была ли уже задача или надо создавать.

 demius год и 4 месяца назад

что-то в процессе создания не отпускает меня ощущение ,что задачи могут прнадлежать нескольким категориям. Например tndt-205 это и фронтенд и wiki и file. tndt-84 это и Справочники и кеши. Даже задача на фильттр по категории будет к Table и r Category

 demius год и 4 месяца назад

Вобще для побуждения писать документацию, стоит всегда считать категорию участвующей в документации. Более того, сделать отдельное поле главного документа категории, который может отображаться на странице категории.

 demius год и 4 месяца назад

Саму сущность то добавить легко, и даже проставлять её задачам и документам, и отображая на странице и в таблицах (и оставив на будущее фильтр по категориям, хотя сам по себе он то же не сложен). Самое трудоемкое это их crud. Категория слишком мелкая, чтобы делаеть её страницу списка, создания, редактирования, они должны быть на вкладке настройки проекта. а значит там должен быть vue, чтобы динамически их вставлять, перемещать, удалять.

 demius год и 4 месяца назад

Попробуем и её впихнуть в 0.4

 demius год и 4 месяца назад

Кстати, в jira, например к задаче можно добавить несколько компонентов. и в целом это видится довольно правильным. Например задача “Добавить фильтр по категории”, она относится к Table или к Категория? Да, большинство задач будут касаться только одной категории, но будут и на работу нескольких подсистем сразу. Да, это можно решить тегами, но они сейчас не в планах, и если сделать так, то придется заводить гору дублирующий категории тегов.

А вот в документах наверное категория привязана жестко. Чтобы по категории потом делать содержания.

 demius год и 4 месяца назад

может кстати вместо Категория назвать её Компонент? У документов могут быть отдельные свои наборы категорий, не связанных с задачами. В задачах это точне называть Подсистемой, но не всем проектам это подходит.

 demius год и 4 месяца назад

очень хотелось бы уместить, и если сделать в минимальном исполнениии, отодвинув дерево на другой релиз, то оно и весьма просто. Не считая круда управления набором категорий. Нет, его конечно можно сделать классически, но тупо. В целом его и на vue сделать должно быть не долго, так что можно попробовтаь сунуть в этот зимний релиз. Будет релиз жирным и прекрасным по задачам именно на новую логику

 demius год и 6 месяцев назад

Фильтрация требует решенную tndt-19, так что если эту берем раньше, придется точно разбивать. Пока что нам нужны хоть какие-то категории.

 demius год и 6 месяцев назад

Надо оценить, насколько это трудоемко, и может быть разбить

  • эта задача - просто плоский список, и для задач и для документов. crud категорий.
  • фильтрация по категориям, категории в меню
  • дерево категорий.
 demius год и 7 месяцев назад

Мы уже начали активно проставлять категорию в заголовках заачи, чтобы не запутаться. Так что вопрос весьма актуален.

Пока можно даже не в виде дерева, а плоским списком, а потом уже доразделять на подкатегории.

 demius 3 года назад

У нас уже в двух проктах появляются серии задач по подсистеме. и очень не хватает возможности их объединять. Для чего-то нужны эпики, а для чего-то категории. При этом часто нужно еще и видеть и задачи и документы по той или иной категории (сейчас в бытовых проектах такие категории оформлены как типы задач, что не очень правильно). Так что функционал весьма востребован и стоит включить его в какой-то из ближайших релизов.

 demius 4 года назад

Задач становится все больше и искать среди них все сложнее. Конечно после реализации tndt-19 лишние можно отфильтровать, но все же стоит повысить приоритет этой, хотя бы в каком-то минималистичном варианте (как у zenmoney, как пути картегорий, без особых изменений роутов без перемещений категорий)

 demius 4 года назад

Будет ли категория влиять на путь к документу/задаче? К документу скорее всего да, к задаче скорее нет.

 demius 4 года назад

В общем базово категоия распространяется и на задачи и на документы. Какие-то категори могут относится только к документам (хотя у них могут быть задачи на документирование, например категория User Guide явно не будет иметь отражения в коде, но будет иметь задачи на написание и обновления гайда)

 demius 4 года назад
  • Справочники (общая)
  • Статистика (общая)
  • Структура проекта (чисто документная)
 demius 4 года назад

Задачам тоже не хватает категорий, это как система подсистема, например Справочники/Стилизация Но какие категории документов мы здесь хотим? Или это общее дерево? Наверняка для документов понадобится, например, инфраструктура, чего не будет в задаче (хотя задачу на документрование или задачи по приведению кода к новым правилам никто не отменял.)

Короч дописать сюда примеры категорий, которые нужны