# Документація pi-apexlang

[English](../en/README.md) · [README проєкту](../../README.md)

`pi-apexlang` поєднує агента розробки pi з ресурсами Oracle для APEXlang. Агент використовує шаблони та настанови Oracle для роботи з файлами застосунку; розширення надає інструмент із визначеними діями для пошуку контексту, створення каркаса, перевірки й діагностики середовища. Імпорт стає доступним через інтерактивний вибір після успішної перевірки на сервері.

Це незалежна інтеграція, а не продукт Oracle. Репозиторій має назву `pi-apex`; назву та версію пакета визначено в [package.json](../../package.json).

## Оберіть матеріал за задачею

| Ваша задача | Посібник |
| --- | --- |
| Установити пакет і перевірити перший застосунок | [Початок роботи](getting-started.md) |
| Зрозуміти компоненти та порядок імпорту | [Архітектура](architecture.md) |
| Знайти дії, параметри та докази результату | [Довідник інструмента](tool-reference.md) |
| Знайти звіти, з'ясувати причини помилок або оновити пакет | [Супровід](maintenance.md) |

## Загальна схема

![Робота з APEXlang: визначити контекст, виконати локальні та компіляторні перевірки, перевірити на сервері й обрати, чи імпортувати застосунок.](../assets/overview.uk.svg)

[Масштабована інфографіка](../assets/overview.uk.svg) · [Зображення PNG](../assets/overview.uk.png)

## Що означає успішна перевірка

| Доказ | Що він підтверджує |
| --- | --- |
| Успішна локальна перевірка | Пройдено вбудовані перевірки словника, DSL і правил валідацій. |
| Успішний аудит compiler-truth | Структуру й атрибути компонентів перевірено за вибраними метаданими компілятора. |
| Підтверджена успішна серверна перевірка | Середовище повернуло докази успіху live-валідатора для знімка застосунку. |
| Успішний імпорт | Перевірка, імпорт і контроль середовища повернули `pass`. |

Самої локальної перевірки недостатньо, щоб підтвердити коректність застосунку на конкретному сервері. Успішна серверна перевірка сама по собі не означає, що застосунок імпортовано.

## Основа документації

Посібники описують пакет **0.5.0**, оновлений **2026-10-21** повним версійованим набором Oracle для 26.1/26.2 з коміту в [`UPSTREAM.json`](../../UPSTREAM.json). Обидві версії мають окремий інвентар (по 389 документів), приклади, compile та deploy. Generation runtime 26.1 збережено; для розробки під 26.2 використовуються його власний інвентар і нова дія `sqlcl_validate`. Серверний імпорт через GUI залишається лише для 26.1.