Знания проекта · 6 мин
Карточка знания без потери контекста
Короткая форма для источника, версии, правила, открытых вопросов и результатов проверки без хранения лишних персональных данных.
После исследования легко запомнить вывод и потерять, откуда он взялся. Через месяц фраза «для услуги нужно назначение» может выглядеть универсальным правилом, хотя она относится к учебному примеру, конкретному снимку конфигурации и одной операции. Карточка знания сохраняет короткую проверяемую выжимку, а не всю историю беседы.
Её задача — ответить на пять вопросов: что узнали, где это нашли, к какой версии относится, что ещё не решено и как факт проверяли. Хорошая карточка позволяет следующему участнику повторить рассуждение или заметить, что исходная версия уже не подходит.
Формат карточки
Практичная запись может содержать такие поля:
- Тема и утверждение: одно конкретное правило простыми словами.
- Проект и источник: точный проект, объект, путь или ссылка на материал.
- Версия: версия конфигурации либо ревизия и снимок, по которым сделан вывод.
- Тип свидетельства: найденный текст, метаданные, связь, наблюдение на форме или результат проверки в работающей системе.
- Условие применимости: операция, роль, режим, данные или границы версии.
- Открытые вопросы: что не подтверждено и кто может согласовать.
- Проверка: способ повторить проверку и полученный результат, если запуск действительно был.
- Дата и владелец актуализации: кто и когда должен перепроверить знание.
Не указывайте версию на глаз. Если индекс сообщает снимок проекта, запишите именно его вместе с ревизией; если используете документацию внешнего инструмента, дайте ссылку и отметьте актуальность. Если доступен только рассказ пользователя, так и укажите: «Источник — владелец проекта, технически не подтверждено».
Пример с честными границами
Карточка учебной заявки может выглядеть так:
Тема: обязательность назначения платежа. Утверждение: в учебной модели назначение обязательно для оплаты услуг и необязательно для возврата средств. Источник: согласованные вводные серии, не реальная база 1С. Версия: синтетическая учебная модель, без версии конфигурации. Тип свидетельства: условие примера. Открытые вопросы: в какой момент проверка должна блокировать действие; какой текст сообщения понятен пользователю. Проверка: матрица содержит обе операции с пустым назначением; реальный прогон не проводился.
Если владелец проекта сообщил, что email связан с физическим лицом и значений может быть несколько, сохраните это как его наблюдение. Источник обозначен, но техническая связь проекта ещё не доказана. Следующей проверкой будет исследование доступной версии конфигурации и формы. Не превращайте такую запись в обобщённое утверждение про все конфигурации.
Не складывайте в карточку персональную историю
Для знания о структуре данных не нужны настоящие адреса сотрудников, телефоны, диагнозы, номера карточек, учетные записи или скриншоты с персональными сведениями. Используйте обезличенные примеры и синтетические значения. Если для воспроизводимости необходима ссылка на закрытый материал, соблюдайте правила доступа и хранения проекта; сама карточка не должна становиться копией закрытого документа.
Не переносите всю переписку с агентом. Сохраните только итоговый факт, основание, применимость и неизвестное. Если ответ агента содержал гипотезу, запишите её как гипотезу, а не как источник. Если новое исследование ей противоречит, создайте актуальную запись или явно отметьте, что старое знание устарело; не стирайте историю изменений там, где она нужна для аудита.
Пересмотр карточки при изменениях
Перед повторным использованием проверьте, совпадают ли проект, ветка и версия. Если форма, правило или права поменялись, старое наблюдение может быть неприменимо. Обновите карточку после проверки источника и пометьте дату; результаты запуска привязывайте к конкретной тестовой базе и ревизии. Статический поиск и проверка в работающей системе — разные типы свидетельства.
Составь короткую карточку знания по найденному правилу. Для каждого утверждения укажи источник и версию либо честно пометь их как неизвестные. Раздели установленный факт, предположение и вопрос владельцу. Не включай персональные данные, всю историю чата и неподтверждённые результаты запуска.
Такую запись удобно использовать после исследования через LEM и связать с поиском происхождения суммы или регрессионными сценариями. Её качество оценивается не длиной, а возможностью понять, к чему относится знание, повторить проверку и заметить, когда оно перестало быть актуальным.