Trans_for_doctors / QUICKSTART_AFTER_FIXES.md
Mintik24's picture
asd
b216c95

🚀 Быстрый старт после исправлений

Что было исправлено:

✅ Зависимости PyQt6 и requests добавлены в pyproject.toml
✅ Папка results/reports/ создана
✅ Документация обновлена
✅ Автосоздание директорий настроено


Шаги для запуска:

1. Обновите зависимости

cd Trans_for_doctors
uv sync

2. Запустите GUI приложение

python run_gui.py

или через uv:

uv run python run_gui.py

3. Проверьте работу

  • Откройте приложение
  • Выберите аудиофайл
  • Введите данные пациента
  • Запустите транскрибирование

Структура папок (создаётся автоматически):

Trans_for_doctors/
├── results/          ← JSON результаты
│   └── reports/      ← DOCX отчёты ✓ создана
└── logs/             ← Логи обработки

Опционально: Интеграция модуля common

Для улучшения кода см. COMMON_INTEGRATION_GUIDE.md

Быстрый старт интеграции логирования:

# В run_gui.py добавьте:
from common import configure_logging

if __name__ == "__main__":
    configure_logging()
    # ... остальной код

Полезные команды:

Запуск CLI (альтернатива GUI):

uv run transmed --audio audio.wav --model . --llm --generate-report

Сборка Windows .exe:

python build_exe.py

Проверка зависимостей:

uv pip list

Документация:

  • APP_ARCHITECTURE.md - полная архитектура проекта
  • USER_GUIDE.md - руководство пользователя
  • COMMON_INTEGRATION_GUIDE.md - интеграция модуля common
  • PROJECT_FIXES_REPORT.md - детальный отчёт об исправлениях

Если возникли проблемы:

  1. PyQt6 не найден:

    uv pip install PyQt6>=6.10.0 PyQt6-sip>=13.8.0
    
  2. Папки не создаются:

    • Проверьте права доступа
    • Запустите с правами администратора (Windows)
  3. Ошибки импорта:

    uv sync --reinstall
    

Всё готово к работе! 🎉