UFO Tech

← UFO Tech

Ashterix

docs: rewrite JsonRpcBundle docs, add SDK docs, move them under docs/api

uk/index.md +54 −20

1 1 # UFO Tech
2 2
3 + **Відкриті інструменти і практичні знання для PHP та Symfony — щоб складні речі робилися просто.**
4 +
3 5 :::info
4 − **UFO Tech** (**_Universal Flexible Open Technologies_**) — це ініціатива, спрямована на створення практичних інструментів і знань для PHP-розробки, API, Symfony та сучасних сервіс-орієнтованих архітектур.
6 + **UFO Tech** (**_Universal Flexible Open Technologies_**) — ініціатива, що створює бібліотеки з відкритим кодом і ділиться досвідом розробки на PHP, Symfony та в сервіс-орієнтованих архітектурах.
5 7 :::
6 8
7 − **Сайт** присвячений ініціативі UFO Tech і обʼєднує технічну документацію, статті та інші матеріали про розробку.
9 + Тут зібрано все, що виростає з цієї ініціативи: бібліотеки та їхня документація, статті, нотатки й розбори реальних задач. Усе — з одного принципу: менше рутини і ручної роботи, більше часу на те, що справді важливо у вашому продукті.
8 10
9 11 :::::columns
10 12 ::::col
11 − :::block
12 − ## Місія
13 −
14 − Мета — спростити процес розробки високофункціональних сервісів, які можуть легко інтегруватися в будь-які проєкти, незалежно від їхньої складності.
15 −
16 − Я прагну забезпечити розробників не тільки інструментами, але й знаннями, які дозволяють використовувати ці інструменти найбільш ефективно.
17 −
18 − Фокус — на прикладних рішеннях: менше абстрактної теорії, більше робочих прикладів, конфігурацій і пояснень, які можна використати у реальному проєкті.
13 + :::block subtitle="Бібліотеки" icon="📦"
14 + Пакети для Symfony та PHP з відкритим кодом під ліцензією MIT: від API і інтеграцій між сервісами до генераторів коду й базових компонентів.
19 15 :::
20 16 ::::
21 17
22 18 ::::col
23 − :::success
24 − ## Чому варто використовувати бібліотеки UFO Tech
25 −
26 − Бібліотеки UFO Tech дозволяють значно спростити процес інтеграції комплексних систем, мінімізуючи потребу у ручній роботі та забезпечуючи високий рівень адаптивності й безпеки.
19 + :::block subtitle="Документація" icon="📚"
20 + Інструкції, приклади й відповіді на питання «а як це працює всередині» — щоб бібліотеку можна було взяти у продакшен, а не лише спробувати.
21 + :::
22 + ::::
27 23
28 − Це ідеальний вибір для проєктів, де потрібні висока гнучкість і відкритий код.
24 + ::::col
25 + :::block subtitle="Знання" icon="💡"
26 + Статті та нотатки про архітектуру, підходи й інструменти: чесно про плюси й мінуси, з прикладами з реальних проєктів.
29 27 :::
30 28 ::::
31 29 :::::
32 30
31 + ## Місія
32 +
33 + Мета — спростити розробку функціональних сервісів, які легко інтегруються в проєкти будь-якої складності.
34 +
35 + Я прагну давати розробникам не лише інструменти, а й знання, як використовувати їх найефективніше. Фокус — на прикладних рішеннях: менше абстрактної теорії, більше робочих прикладів, конфігурацій і пояснень, які можна одразу взяти у свій проєкт.
36 +
37 + ## Принципи
38 +
39 + * **Практика понад теорію.** Кожна бібліотека з'являється з реальної задачі й перевіряється в реальних проєктах.
40 + * **Мінімум рутини.** Те, що можна вивести з коду, бібліотека виводить сама: конфігурацію, документацію, перетворення даних.
41 + * **Рідні механізми Symfony.** Жодних власних «велосипедів» там, де фреймворк уже має рішення, — бібліотеки вбудовуються у ваш застосунок звичним способом.
42 + * **Відкритість.** Код, issue та обговорення — публічні; розширення й внески вітаються.
43 +
44 + ## Бібліотеки
45 +
46 + **API та інтеграції між сервісами**
47 +
48 + * [JsonRpcBundle](/docs/api/json-rpc-bundle) — JSON-RPC сервер для Symfony: будь-який сервіс стає API з валідацією, документацією й кешем.
49 + * REST Bundle, MCP Bundle, RPC Mercure Transport — розширення: REST-ендпоінти, інструменти для AI-агентів, транспорт через Mercure.
50 +
51 + **Клієнти й генератори коду**
52 +
53 + * [SDK](/docs/api/sdk) — типізовані клієнти для JSON-RPC API на PHP і Symfony, TypeScript-типи з документації OpenRPC.
54 +
55 + **Базові компоненти**
56 +
57 + * DTO Transformer, RPC Objects, RPC Exceptions, транспортні контракти — компоненти, на яких побудовані інші бібліотеки; їх можна використовувати й окремо.
58 +
59 + Повний перелік пакетів — на [Packagist](https://packagist.org/packages/ufo-tech/), код — на [GitHub](https://github.com/UFO-Tech). Документація на сайті поповнюється: розділи для нових бібліотек з'являтимуться поступово.
60 +
33 61 ## Що є на сайті
34 62
35 − - Документація та інструкції з інтеграції бібліотек
36 − - Матеріали про PHP, Symfony, JSON-RPC, API та архітектуру сервісів
37 − - Дублікати публікацій із Telegram-каналу
38 − - Практичні нотатки, кейси та корисні технічні статті
63 + - [Документація](/docs/api/json-rpc-bundle) бібліотек UFO Tech
64 + - [Статті](/articles/api/rpc_vs_rest_vs_graphql) про PHP, Symfony, архітектуру й інструменти розробки
65 + - Публікації з Telegram-каналу
66 + - Практичні нотатки, кейси й розбори реальних задач
39 67
68 + ## Долучайтеся
69 +
70 + * [Telegram-канал](https://t.me/php_while_true) — нові матеріали та обговорення
71 + * [GitHub UFO-Tech](https://github.com/UFO-Tech) — код, issue і pull request-и: повідомляйте про помилки, пропонуйте зміни, пишіть розширення
72 + * [Packagist](https://packagist.org/packages/ufo-tech/) — усі пакети
73 +
40 74 ## Ліцензія
41 75
42 − Код у репозиторіях UFO Tech зазвичай поширюється під ліцензією MIT, якщо в конкретному репозиторії не вказано інше.
76 + Код у репозиторіях UFO Tech поширюється під ліцензією MIT, якщо в конкретному репозиторії не вказано інше. Використовуйте вільно — у pet-проєктах і в продакшені.