Как стать автором
Обновить

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

Время на прочтение 2 мин
Количество просмотров 7.5K
Достаточно часто поднимается вопрос о том, кто и как называет организовывает файлы (речь идет не о системах хранения версий, а именно о способе организации файлов и директорий). Или не называет, а хранит как придется. Буквально вчера коллега в Useful Сlub задал аналогичный вопрос. Я, пожалуй, зафиксирую свой ответ и здесь, вдруг кому-то еще наш способ поможет сэкономить время.
Тут еще важно понимать вот что — это ваша внутренняя нотация, заказчику по большому счету все равно какое название у файла. Поэтому организация должна быть такой, как удобно вам и вашим коллегам.

Мы используем вот такой формат: ABC.Phase.SubLabel.State.0.01.doc, где:
  1. ABC
    Код проекта для учета логов внутри компании и тикетов по проекту. Также используется в письмах, отчетах и любых других местах, где упоминается проект, чтобы настраивать фильтры. Генерируется по буквам под ударением. Пример: проект имеет название «Ozon», значит его код будет OZN.

  2. Phase
    Текущая фаза проекта. Основные фазы и типы документов регламентированы, но в зависимости от проекта их набор может меняться. Общий список фаз таков:
    • Presale
      Содержит все возможные данные, выясненные в ходе предпродажной подготовки: презентации, контакты стейкхолдеров, клиентские брифы, рекламные материалы и всякое такое.

    • Research
      Исследования рынка, предметной области, устоявшихся практик, конкурентов;

    • Analysis
      Данные обследования компании: цели и задачи, пользовательские классы, структура компании, бизнес-модель и внутренние/внешние процессы, требования к системе и все такое.

    • Concept
      Концептуальное видение проекта: wireframes, ИА, сценарии, персонажи, перечень и краткое описание функционала;

    • Project
      Непосредственно постановка задачи на разработку, дизайн, тестирование, контент, интеграцию;

    • WBS
      Декомпозиция работ по проекту;
  3. SubLabel
    Название части фазы. Например, если текущая фаза Analysis, то SubLabel может быть указанием на содержание: Rival, UserClasses, Scope.

  4. State
    Текущий статус фазы. Бывает двух видов: draft или stable. Влияет на использование документа внутри компании. Наружу (клиенту) отдается только stable, из него же и вытекает следующая фаза. Draft — это промежуточный результат, который циркулирует только между проектировщиками и менеджерами.

  5. Мажорная версия
    Отвечает на вопрос: сколько раз документ был направлен на утверждение заказчику. Если цифра больше 3-5, то обычно это означает, что кто-то лажает на проекте: плохо проведена предыдущая фаза и данные не полные, менеджер не справляется с маршрутизацией задач, проектировщик плохо спроектировал функционал, что вызвало дополнительные вопросы и, как следствие, еще несколько циклов. Версия всегда устанавливается менеджером.

  6. Минорная версия
    Количество изменений, внесенных в проект. Используется только внутри проектировщиков: например, для проверки качества документации, прототипов. Если результат получился не полным (что-то упустили), то инкрементируется минорная версия и документ отправляется на доработку. Устанавливается только проектировщиком или руководителем отдела проектирования.
Директории называем по текущей фазе. Прототипы по схожему принципу: ABC.Concept.Prototype.Stable.0.01 или ABC.Project.Prototype.Draft.0.01

Наша схема, на первый взгляд, выглядит немного монструозно, но она логична, читаема и, что самое важное — проверена годами.
Теги:
Хабы:
+25
Комментарии 23
Комментарии Комментарии 23

Публикации

Истории

Работа

Ближайшие события

Московский туристический хакатон
Дата 23 марта – 7 апреля
Место
Москва Онлайн
Геймтон «DatsEdenSpace» от DatsTeam
Дата 5 – 6 апреля
Время 17:00 – 20:00
Место
Онлайн