> ## Documentation Index
> Fetch the complete documentation index at: https://docs.layeron.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Ключевые понятия

> Workspace, project, chat, preview, Cloud, credits и extensions в Layeron.

## Workspace

Workspace — это рабочее пространство с тарифом, участниками и лимитами. Все проекты принадлежат workspace.

В одном workspace может быть несколько проектов и участников (на платных тарифах).

## Project

Project — отдельное приложение с файлами, чат-историей, preview и настройками публикации. Каждый проект имеет:

| Поле          | Описание                                                                |
| ------------- | ----------------------------------------------------------------------- |
| name          | Название проекта                                                        |
| slug          | Уникальный идентификатор в URL                                          |
| type          | Тип: `frontend`, `fullstack`, `service`                                 |
| public        | Публичный или приватный                                                 |
| preview       | Текущий preview URL                                                     |
| deploy status | Статус deploy: `building`, `deployed`, `failed`, `fixing`, `hibernated` |

## Типы проектов

| Тип         | Описание                                  |
| ----------- | ----------------------------------------- |
| `frontend`  | Статическое приложение (React, Vue, etc.) |
| `fullstack` | Приложение с серверной логикой            |
| `service`   | API-сервис или бэкенд                     |

## Chat

Chat — главный способ создавать и менять приложение. Вы пишете запросы, AI генерирует код, вы проверяете результат в preview и просите правки.

## Generation

Generation — процесс генерации кода AI. Вы отправляете запрос в чат, AI анализирует задачу, создает файлы и компоненты, результат отображается в preview.

### Этапы генерации

| Этап          | Что происходит                             |
| ------------- | ------------------------------------------ |
| Анализ        | AI изучает запрос и контекст проекта       |
| Планирование  | Определяет, какие файлы и компоненты нужны |
| Создание кода | Генерирует файлы, стили, компоненты        |
| Проверка      | Валидирует код и исправляет ошибки         |
| Результат     | Показывает preview и описывает изменения   |

## Preview

Preview — быстрая проверка результата после генерации или деплоя. Отображается в интерфейсе проекта.

## Cloud

Cloud — изолированное окружение для запуска проекта. Включает:

* **Resources** — CPU, RAM, лимиты тарифа
* **Storage** — файлы и ассеты проекта
* **Env** — переменные окружения
* **Logs** — логи запуска и работы

## Credits

Credits — единицы использования AI-генерации. Тратятся на каждый запрос к AI. Количество credits зависит от тарифа.

## Extensions

Extensions — внешние сервисы и интеграции, которые проект может использовать: аутентификация, базы данных, API, storage и т.д.

## Hibernation

Hibernation — остановка неактивного контейнера. Файлы проекта сохраняются, но процесс приложения не работает. Первый запрос после простоя может быть медленнее.

<Info>
  Первый проект в Layeron通常 требует только Workspace, Project и Chat. Cloud нужен позже — когда проект должен работать как живое приложение.
</Info>