PD-Audit: Аудит проектной документации

Задание

Задание #19: Аудит проектной документации

Инженеры и команды, работающие с проектной документацией, тратят сотни часов на проверку соответствия нормам и качества, а также на поиск противоречий между разделами. Документы большие, требования обновляются, и работать с объёмом тяжело.

Идея — инструмент, который не заменяет инженеров, а кратно ускоряет проверку:
- Нормативные требования (СП/СНиП/ГОСТ, чек-листы)
- Контроль качества всей ПД (несоответствия, отсутствие блоков данных, противоречия)
- Общение с ИИ по ПД и нормативной базе
- Доступ к актуальной базе нормативных документов в виде чата

Команда

ИИнженеры — команда из 3-х человек:

Проблема

Инженеры тратят сотни часов на проверку проектной документации. Нормативные документы постоянно меняются, работать с большими объёмными документами сложно, а ошибки дорого обходятся.

У кого проявляется:
- Проектные бюро и архитектурные мастерские
- Строительные компании, девелоперы, застройщики
- Инжиниринговые компании и технические заказчики

Решение (MVP)

Инструмент для автоматической проверки проектной документации (раздел ПБ — пожарная безопасность) на соответствие нормативным требованиям.

Статус: MVP v0.1.0 реализован ✅

Реализованные возможности:
- ✅ Загрузка PDF документов (до 50 МБ, до 100 страниц)
- ✅ Выбор разделов документации для проверки (4, 5, 6, 9)
- ✅ Выбор нормативов для проверки (5 стандартов)
- ✅ Просмотр отчёта с нарушениями
- ✅ Экспорт отчёта в PDF и Excel

⚠️ Используются заглушки (stubs) для:
- Парсинга PDF документов
- Анализа документов с помощью LLM

Это позволяет протестировать UI/UX и архитектуру системы, пока команда анализа разрабатывает реальные алгоритмы.

Технологии

Backend:
- Python 3.11+, FastAPI, Pydantic
- ReportLab (PDF export), openpyxl (Excel export)

Frontend:
- TypeScript 5.x, Next.js 14+, React 18+
- Tailwind CSS, React Query (TanStack)

Быстрый старт

Вариант 1: Docker Compose (рекомендуется)

# Запуск всего стека
docker-compose up --build

# Приложение будет доступно:
# - Frontend: http://localhost:3000
# - Backend API: http://localhost:8000
# - API Docs: http://localhost:8000/docs

Вариант 2: Локальная разработка

Backend

cd backend
poetry install
poetry run uvicorn src.main:app --reload --port 8000

Frontend

cd frontend
npm install
npm run dev

Фокус MVP — разделы ПБ

Раздел 4: Система предотвращения пожара
- Проверка эвакуационных путей, ширины выходов
- Нормативы: СП 1.13130.2020, СП 4.13130.2013, СП 8.13130.2020

Раздел 5: Система противопожарной защиты
Раздел 6: Организационно-технические мероприятия
Раздел 9: Мероприятия по обеспечению доступа инвалидов

Поддерживаемые нормативы: GOST-R-53961-2010, FZ-123

API Endpoints

• POST /api/v1/upload - Загрузка PDF документа
• POST /api/v1/analyze - Запуск анализа документа
• GET /api/v1/report/{id} - Получение отчёта
• GET /api/v1/standards - Список доступных нормативов
• GET /api/v1/sections - Список разделов ПД
• GET /api/v1/export/{id}?format=pdf|excel - Экспорт отчёта

Полная документация: http://localhost:8000/docs

Структура репозитория

├── task/                  # Исходное задание
├── pd-audit/              # Проектная документация
│   ├── 01-brief.md        # Бриф проекта
│   ├── 02-user-story-map.md
│   ├── 03-nfr.md          # Нефункциональные требования
│   ├── 04-lean-canvas.md
│   └── 05-market-research.md
├── lean_canvas/           # Lean Canvas
└── README.md

Ценностное предложение

«Copilot для проектной и инженерной документации»

Мы не заменяем инженеров — мы даём мощный инструмент для кратного повышения эффективности:

1. Проверка нормативных требований — СП, СНИПы, ГОСТы, оформление, по отдельным разделам ПД, чек-листы
2. Контроль качества всей ПД — несоответствия между разделами, отсутствие блока данных, противоречия
3. Общение с ИИ по ПД — любые вопросы по документации и нормативной базе
4. База нормативных документов — доступ к актуальной информации + работа с базой в виде чата

Лицензия

MIT