Проект про коробочки

Пример README для хакатона. Замените содержимое на свой кейс, структуру оставьте.

Кейс

AI-агент, который сам следит за БЛА БЛА БЛА.

Боль (as-is)

Сейчас за сроками следят вручную: инженер раз в неделю БЛА БЛА БЛА

• БАЛ БАЛ БЛА «протухают» незаметно → даунтайм сервиса и потеря доверия клиентов;
• вообще все плохо;
• нет единой картины «кто и за что отвечает».

Цифра боли: ~40 провалов под присмотром, проверка вручную съедает ~3 часа в неделю, и за последний год было 2 инцидента с зелеными тапочкамми.

Что делает агент

1. Раз
2. Два
3. Три
4. Конец

Демо (что показываем жюри)

Запускаем на тестовом наборе → агент находит артефакт → выводит отчёт и готовый текст задачи. 2 минуты, живьём.

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

# установка
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# запуск на тестовых данных
python src/main.py --input data/certs_sample.csv

Метрики успеха

• Ручная проверка: с ~3 часов/неделю до ~0 (агент сам отдаёт сводку).
• Инциденты с истёкшим сертом: цель — 0.
• Среднее предупреждение заранее: ≥14 дней до истечения.

Стек

• Python 3.12
• Claude (через Claude Code) — генерация текста задачи и сводки
• Данные: обезличенный CSV (реальные не используем)

Чего НЕ делаем за хакатон (честно про скоуп)

• Не лезем в реальные сертификаты и боевую инфру — только тестовый набор.
• Автопродление не делаем: агент готовит черновик, решение и оплата — за человеком.
• Интеграцию с трекером оставляем на «дальше».

Команда

• <имя> — <роль>
• <имя> — <роль>