# DevOpsLab Web Interface

Веб-интерфейс для управления Ansible ролями в проекте DevOpsLab.

**Автор:** Сергей Антропов  
**Сайт:** https://devops.org.ru

## 🚀 Быстрый старт

### Установка зависимостей

```bash
cd app
pip install -r requirements.txt
```

### Настройка окружения

```bash
cp .env.example .env
# Отредактируйте .env файл
```

### Запуск приложения

```bash
# Режим разработки
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# Или через Python
python main.py
```

### Доступ к приложению

- Веб-интерфейс: http://localhost:8000
- API документация: http://localhost:8000/api/docs
- ReDoc: http://localhost:8000/api/redoc

## 📁 Структура проекта

```
app/
├── api/v1/endpoints/    # API endpoints
├── core/                # Ядро (config, make_executor)
├── models/              # Модели данных
├── services/            # Бизнес-логика
├── templates/           # HTMX шаблоны
├── static/              # Статические файлы
├── tasks/               # Celery задачи
├── db/                  # База данных
└── main.py              # Точка входа
```

## 🔧 Разработка

### Добавление нового endpoint

1. Создайте файл в `api/v1/endpoints/`
2. Создайте роутер с endpoints
3. Подключите роутер в `api/v1/router.py`

### Добавление новой страницы

1. Создайте шаблон в `templates/pages/`
2. Добавьте роут в `main.py`
3. Используйте `base.html` как базовый шаблон

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

Полная документация находится в `docs/`:
- `WEB_INTERFACE_PROPOSAL.md` - Полное предложение
- `WEB_INTERFACE_DETAILS.md` - Детали работы
- `WEB_INTERFACE_DEPLOY_IMPORT_EXPORT.md` - Деплой, импорт, экспорт