Project Pulse

Это очищенное ядро инструмента, которым PMB Consulting ведёт собственный портфель проектов. Внутренние привязки, доступы и данные из него убраны, механика осталась целиком. Инструмент рассчитан на одного владельца и на запуск на своей машине или своём сервере.

Тот же код лежит открытым репозиторием на GitHub - если вам удобнее клонировать, а не качать архив, берите оттуда. Содержимое совпадает файл в файл.

Разворачиваете с помощью ИИ-агента - отдайте ему архив вместе со стартовым промптом: в нём написано, что это за пакет, в каком порядке его читать и чего делать не нужно. Тот же файл лежит и внутри архива.

Что видно на экране

• Главная - вывод дня («в работе столько-то из стольких-то, ближе всех к сдаче вот это»), закреплённые проекты с кольцами готовности и сводка портфеля.
• Все проекты - список по направлениям, с фильтрами по статусу, типу и поиском по названию.
• Карточка проекта - описание, текущее состояние, прогресс по блокам, все планы проекта, хвост «что дальше», ссылки и путь к папке с кодом.
• Страница плана - фазы с отметками, кнопки «отметить фазу» и «закрыть план», оценка ценности плана.
• Канбан - те же проекты доской по статусам.
• Идеи - инбокс коротких заметок с автопривязкой к проектам по смыслу.
• Бэклог - хвосты «дальше» всех живых проектов одним списком.
• Реализовано - полка закрытых проектов с накопленным результатом.
• Избранное и поиск - закреплённые планы и поиск по заголовкам и телу всех планов.

Что он делает сам

• Считает прогресс проекта по чек-боксам в разделе «Блоки» карточки.
• Считает прогресс плана по отметкам фаз и сам определяет статус плана.
• Ранжирует проекты по двум осям, деньги и скорость: «быстро и дорого» наверх.
• Подсказывает, что пора ревизовать: неоценённые и залежавшиеся планы.
• Прикидывает трудоёмкость в часах и деньгах по количеству фаз.
• Берёт даты «изменён» из git-истории, если хранилище под git.
• Привязывает идею к проекту по направлению и общим словам в названии.

Что делает по кнопке

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

Каждая правка точечная: меняется одна строка файла, перед записью делается копия, операция пишется в журнал. Правка выключена по умолчанию - пока не заданы три переменные окружения, интерфейс работает только на чтение и честно об этом пишет.

Как запустить

Нужен Python 3.9 или новее и десять минут. Ни базы, ни докера, ни внешних сервисов. Демо на выдуманных данных поднимается тремя командами и работает офлайн, без ключей и без единого обращения в сеть.

tar xzf project-pulse-1.1.1.tar.gz cd project-pulse-1.1.1 bash scripts/run_demo.sh

Дальше интерфейс открывается в браузере на демо-данных вымышленной мастерской. Чтобы подключить своё хранилище, укажите путь к папке с markdown-файлами. Направления портфеля задаются одним файлом-справочником, всё остальное - переменные окружения: где лежит хранилище, включена ли правка, ставка часа, веса оценок, пороги ревизии.

Что внутри архива

• Ядро на FastAPI и Jinja2, шаблоны и стили интерфейса.
• Набор тестов, включая «золотой снимок» выдачи.
• Синтетическое демо на выдуманных данных и проверка окружения одной командой.
• Файл контрольных сумм на каждый файл пакета.
• Документация: как всё устроено внутри и куда встраивать своё, что защищено и чего не делать, что вычищено из исходного проекта, история версий, лицензия и список сторонних компонентов.

Что проверено

• 282 теста зелёные на машине с git; в окружении без git ещё несколько тестов дат пропускаются намеренно.
• Сборка проверена в одноразовом контейнере с отключённой сетью: распаковка, совпадение всех контрольных сумм, установка зафиксированных зависимостей офлайн, живые страницы.
• Отдельный наступательный аудит безопасности: два независимых проверяющих искали уязвимости так, как искал бы атакующий. Критических дыр не нашлось; четыре находки, важные при выставлении в сеть, закрыты, и каждую теперь держит свой тест.
• Секретов, ключей и следов чужой инфраструктуры в пакете нет.

Чего эти проверки не доказывают: нагрузка, большие объёмы и многопользовательский доступ не проверялись, инструмент рассчитан на одного владельца. Контрольная сумма подтверждает целостность файла, но не личность отправителя. Полный отчёт лежит внутри архива.

Чего здесь нет

Уведомлений в мессенджеры, интеграций с внешними трекерами, скриптов выкатки, многопользовательского доступа и ролей, аналитики, мобильного приложения. Это ядро, на котором такое можно построить, а не готовый продукт под ключ. Куда именно встраивать своё - написано в документации внутри архива.