Skip to content

The open alternative to Salesforce, designed for AI.

i18n - docs translations (#29332)

twenty-pr[bot]af4c511cb565
diff --git a/packages/twenty-docs/ar/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/ar/developers/extend/apps/getting-started/local-server.mdx
index eecc689d1f2..18568e9be3b 100644
--- a/packages/twenty-docs/ar/developers/extend/apps/getting-started/local-server.mdx
+++ b/packages/twenty-docs/ar/developers/extend/apps/getting-started/local-server.mdx
@@ -1,38 +1,101 @@
---
-title: الخادم المحلي
-description: صِل واجهة سطر الأوامر المستقلة بخادم Twenty محلي.
+title: البيئة المحلية
+description: شغّل بيئة تطوير Twenty الكاملة باستخدام واجهة سطر الأوامر.
---
import { PageBanner } from "/snippets/page-banner.mdx"
-## إعداد
+## ابدأ Twenty محليًا
-تتصل واجهة سطر الأوامر المستقلة بخادم Twenty قيد التشغيل. لا يبدأ حاويات Docker ولا يديرها.
+ثبّت Docker وابدأ تشغيله، ثم نفّذ:
-استخدم [دليل الاستضافة الذاتية](/ar/developers/self-host/self-host) لتشغيل Twenty باستخدام Docker. في نسخة مستودع Twenty المُخرَجة، تعمل أيضًا بيئة التطوير الحالية:
+```bash
+twenty local start
+twenty auth login --url http://localhost:2020 --name local
+```
+
+يشغّل `local start` واجهة الويب وAPI والعامل وقواعد البيانات. يعمل خارج مجلد التطبيق
+وينتظر حتى تصبح البيئة جاهزة، ويطبع عنوان URL الخاص بها. تسجيل الدخول
+خطوة منفصلة. لتثبيت تطبيقك بعد ذلك، شغّل `twenty app apply --create --remote local` من دليله.
+
+بالنسبة إلى مثيل جديد، مرّر إصدارًا صراحةً أو دع واجهة سطر الأوامر تختار أعلى
+إصدار منشور يطابق `engines.twenty` الخاص بتطبيقك. خارج تطبيق يتضمن هذا
+الإعداد، يستخدم `latest`. تحتفظ المثيلات الحالية بإصدارها وبياناتها.
+بالنسبة إلى مثيل موجود، يُتحقق من التوافق مع `engines.twenty` باستخدام
+`APP_VERSION` الخاص بالصورة، بما في ذلك عندما تكون علامتها `latest`. يؤدي الإصدار المفقود أو غير الصالح
+أو غير المتوافق إلى إصدار تحذير ومتابعة بدء التشغيل.
```bash
-bash packages/twenty-utils/setup-dev-env.sh
-yarn start
+twenty local start 2.53.1
+twenty local status
+twenty local logs
+twenty local logs --lines 100 --no-follow
+twenty local stop
```
-ثم صادِق باستخدام عنوان URL للخادم لمساحة عملك:
+تستمع المثيلات الجديدة فقط على واجهة الاسترجاع المحلي، على المنفذ `2020`. استخدم `--port \<port>` عند
+إنشاء مثيل لاختيار منفذ آخر. استخدم سياق مقبس Docker محليًا؛
+لا تدعم هذه الأوامر محركات Docker البعيدة.
+
+## الترقية أو إعادة التعيين
```bash
-twenty auth login --url http://localhost:3000 --name local
-twenty app apply --create --remote local
+twenty local upgrade 2.53.1
+```
+
+تسحب الترقية الصورة المطلوبة قبل استبدال المثيل. تحافظ على
+منافذه وقاعدة بياناته ووحدات تخزين ملفاته وتجاوزات البيئة الخاصة به. تُطبَّق الإعدادات الافتراضية الجديدة لـ CLI على المثيلات المنشأة حديثًا؛ وتحافظ الترقيات على قيم البيئة الحالية.
+من دون إصدار، يتبع اختيار الإصدار نفسه كما في بدء جديد. تُرفَض تخطيطات التخزين المخصصة. تُرفَض عمليات الرجوع إلى إصدار أقدم قبل استبدال الحاوية، بما في ذلك عند استخدام وسم مثل `latest`. يجب أن تعلن كلتا الصورتين عن `APP_VERSION` صالح حتى يتمكن CLI من مقارنة إصداريهما الفعليين.
+
+مرّر `2.53` للبدء أو الترقية باستخدام وسم صورة `v2.53` العائم، أو `2.53.1` لاختيار إصدار تصحيح محدد.
+
+إذا فشل إنشاء البديل أو أُلغي، يستعيد CLI الحاوية والإعدادات السابقتين. بمجرد بدء الإصدار الجديد، تحتفظ الترقيات الفاشلة بوحدات تخزين البيانات، لكنها لا تتراجع عن ترحيلات قاعدة البيانات.
+
+يحتفظ `stop` بجميع البيانات. لحذف المثيل وبياناته نهائيًا، شغّل:
+
+```bash
+twenty local reset
+twenty local start
```
-استخدم عنوان URL والمنفذ الفعليين لخادمك. لمساحات العمل ذات النطاقات الفرعية، استخدم اسم مضيف مساحة العمل.
+يطلب إعادة التعيين التأكيد. يجب أن تمرر البرامج النصية `--yes`. لا تُزال الاتصالات البعيدة المحفوظة وبيانات الاعتماد.
## اختبارات التكامل
-استخدم خادمًا منفصلًا أو مساحة عمل منفصلة قابلة للتخلص منها. يؤدي إعداد اختبار التكامل إلى تثبيت تطبيق، بينما يؤدي التنظيف إلى إلغاء تثبيته. عيّن `TWENTY_API_URL` و`TWENTY_API_KEY` لمثيل الاختبار هذا قبل تشغيل `yarn test`.
+استخدم مثيل الاختبار المنفصل، بالمنفذ الافتراضي `2021`:
+
+```bash
+twenty local start --test
+twenty local status --test
+TWENTY_API_URL=http://localhost:2021 yarn test
+```
+
+عيّن `TWENTY_API_KEY` إلى مفتاح لذلك المثيل. تثبّت اختبارات التكامل تطبيقًا
+وتلغي تثبيته، لذا أبقها منفصلة عن مساحة عمل التطوير الخاصة بك.
+مرّر `--test` إلى السجلات أو الإيقاف أو الترقية أو إعادة التعيين عند إدارة هذا المثيل.
+
+يوفّر سير عمل CI المُنشأ مثيلًا معزولًا عبر
+`twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` ويثبّت
+واجهة سطر الأوامر المستقلة بشكل منفصل.
+
+## إعدادات محلية أخرى
+
+بالنسبة إلى نسخة مصدر تم سحبها من Twenty، تعمل بيئة التطوير الحالية أيضًا:
+
+```bash
+bash packages/twenty-utils/setup-dev-env.sh
+yarn start
+twenty auth login --url http://localhost:3000 --name local
+```
-يوفّر سير عمل CI المُنشأ مثيلًا معزولًا عبر `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` ويثبّت واجهة سطر الأوامر المستقلة بشكل منفصل.
+استخدم عنوان URL والمنفذ الفعليين لخادمك. بالنسبة إلى مساحات العمل ذات النطاقات الفرعية، استخدم
+اسم مضيف مساحة العمل. للنشر في بيئة الإنتاج، اتبع
+[دليل الاستضافة الذاتية](/ar/developers/self-host/self-host).
## تبعيّات المشروع
-ثبّت `twenty-sdk` و`twenty-client-sdk` كتبعيّات للمشروع. ثبّت واجهة سطر الأوامر `twenty` على مستوى النظام، ثم شغّل `twenty app typecheck` و`twenty app build` و`twenty app apply` من دليل التطبيق.
+ثبّت `twenty-sdk` و`twenty-client-sdk` كتبعيّات للمشروع. ثبّت واجهة سطر الأوامر
+`twenty` على مستوى النظام، ثم شغّل `twenty app typecheck` و`twenty app build` و
+`twenty app apply` من دليل التطبيق.
<PageBanner illustration="dev-self-host" />
diff --git a/packages/twenty-docs/ar/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/ar/developers/extend/apps/getting-started/troubleshooting.mdx
index 413becf5d72..1217f07404e 100644
--- a/packages/twenty-docs/ar/developers/extend/apps/getting-started/troubleshooting.mdx
+++ b/packages/twenty-docs/ar/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -7,7 +7,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"
## المشكلات الشائعة
-* **أخطاء الخادم المحلي**، تحقّق من بيئة تطوير Docker أو المستودع لديك. لا تدير واجهة CLI المستقلة الحاويات.
+* **أخطاء البيئة المحلية**، تحقّق من `twenty local status` و`twenty local logs --no-follow`. يجب تثبيت Docker وتشغيله باستخدام سياق مقبس محلي. أضف `--test` لمثيل الاختبار. يؤدي فشل البدء إلى الاحتفاظ بالحاوية وبياناتها للتشخيص.
* **إصدار Node غير صحيح** — تحتاج إلى 24.5+ أو 26.5+ (`engines.node: ^24.5.0 || ^26.5.1`). تحقّق باستخدام `node -v`.
* **Yarn 4 غير موجود** — شغّل `corepack enable` (على Node 26، نفّذ أولاً `npm install -g corepack`).
* **تبعيات تالفة** — `rm -rf node_modules && yarn install`.
diff --git a/packages/twenty-docs/ar/developers/extend/apps/logic/credits.mdx b/packages/twenty-docs/ar/developers/extend/apps/logic/credits.mdx
index 418e7c8f255..f4dac42576c 100644
--- a/packages/twenty-docs/ar/developers/extend/apps/logic/credits.mdx
+++ b/packages/twenty-docs/ar/developers/extend/apps/logic/credits.mdx
@@ -82,24 +82,28 @@ billing: {
## العمليات القابلة للفوترة
-العملية هي ما يفرض تطبيقك رسومًا مقابله أثناء عمله. يربط كل إدخال اسم عملية تختاره بفئة الفوترة التي تقيسها المنصة، بالإضافة إلى التسمية التي تظهر لمشرفي مساحة العمل في **Settings > Usage**.
+العملية هي ما يفرض تطبيقك رسومًا مقابله أثناء عمله. يُسمّي كل إدخال عمليةً تختارها والتسمية المعروضة لمسؤولي مساحة العمل في **الإعدادات > الاستخدام** ولك في مخطط **الأرصدة المستخدمة** للمراقبة في تطبيقك. يمكنه اختياريًا التعيين إلى إحدى فئات فوترة المنصة.
```ts src/application-config.ts
billing: {
operations: {
+ enrichPerson: {
+ label: 'Person enrichment',
+ icon: 'IconUserSearch',
+ },
recordMeeting: {
operationType: 'CALL_RECORDING',
label: 'Meeting recording',
},
- summarizeMeeting: {
- operationType: 'AI_CHAT_TOKEN',
- label: 'Meeting summary',
- },
},
},
```
-يجب أن تكون `operationType` إحدى فئات الفوترة في المنصة: `AI_CHAT_TOKEN` أو `AI_WORKFLOW_TOKEN` أو `WORKFLOW_EXECUTION` أو `CODE_EXECUTION` أو `WEB_SEARCH` أو `CALL_RECORDING` أو `EMAIL_SEND`. وهي تحدد كيفية قياس الإنفاق ووحدة العد المطبقة (الرموز المميزة أو الاستدعاءات أو الدقائق) — وليست ما يقرؤه المشرفون. إنما `label` هي ذلك.
+`icon` اختياري: اسم أيقونة Twenty (مثلًا `IconUserSearch`) يُعرض بجانب التسمية في تفصيل أرصدة تطبيقك على صفحة إعداداته.
+
+`operationType` اختياري وتكون قيمته الافتراضية `APP_OPERATION`، الفئة المخصصة لرسوم التطبيق. عيّنه فقط عندما يكون الإنفاق بالفعل إحدى فئات المنصة: `AI_CHAT_TOKEN`، `AI_WORKFLOW_TOKEN`، `WORKFLOW_EXECUTION`، `CODE_EXECUTION`، `WEB_SEARCH`، `CALL_RECORDING`، `EMAIL_SEND`، `APP_OPERATION`. وهي تحدد كيفية قياس الإنفاق ووحدة العد المطبقة (الرموز المميزة أو الاستدعاءات أو الدقائق) — وليست ما يقرؤه المشرفون. إنما `label` هي ذلك.
+
+يمثل `CODE_EXECUTION` المكان الذي تقيس فيه المنصة عمليات التشغيل الخاصة بدوالك، لذا تختلط الرسوم المُسجَّلة هناك بها؛ يُفضَّل استخدام الخيار الافتراضي.
يرفض الإصدار قيمة `operationType` غير معروفة، وقيمة `label` فارغة، واسمًا مستخدمًا لكل من رسم متكرر وعملية.
@@ -123,8 +127,8 @@ await chargeCredits({
* يتيح إعلان العمليات لـ Usage تقسيم إنفاق تطبيقك بحسب ما فُرضت رسوم مقابله. يستمر الإبلاغ عن التطبيق الذي لا يعلن شيئًا، كشريحة واحدة تحت اسم العرض الخاص به.
* يُرفض تحصيل رسوم لعملية لا يعلن عنها ملف البيان الخاص بك. أضفها إلى `billing.operations` ثم قم بالمزامنة.
-* يمكن لعدة عمليات مشاركة `operationType` واحد. تظهر عمليتا إثراء كلتاهما مقاستين كـ `CODE_EXECUTION` على شكل شريحتين منفصلتين بتسميتين.
-* من دون `operation`، سمِّ فئة الفوترة مباشرةً باستخدام `operationType`، وبشكل اختياري باستخدام `resourceContext` حرّ التنسيق. الصيغتان متنافيتان: تحمل `operation` التسمية، بينما لا تحملها `operationType`.
+* يمكن لعدة عمليات مشاركة `operationType` واحد. تظهر عمليتا إثراء، تُقاسان كلتاهما باعتبارهما `APP_OPERATION`، كشريحتين تحمل كل منهما تسمية.
+* من دون `operation`، تُسجَّل الرسوم ضمن `APP_OPERATION`، أو ضمن الفئة التي تسميها باستخدام `operationType`، مع `resourceContext` حرّ الصياغة اختياريًا. الصيغتان متنافيتان: تحمل `operation` التسمية، بينما لا تحملها `operationType`.
* لا يتسبب التحصيل مطلقًا في فشل دالتك. يُسجَّل خطأ الفوترة ويُتجاهل، ولا ينتج عن الاستدعاء أي إجراء خارج وقت تشغيل الدالة المنطقية كي لا تتعطل عمليات التشغيل والاختبارات المحلية.
## التحقق قبل الإنفاق
diff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx
index e7c13119664..0151706d301 100644
--- a/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx
+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx
@@ -33,6 +33,7 @@ twenty --version
| `api` | إرسال طلبات REST أو GraphQL الأولية |
| `افتح` | فتح مساحة العمل في متصفحك |
| `app` | إنشاء التطبيقات وبناؤها ومزامنتها وتصحيحها وإلغاء تثبيتها |
+| `محلي` | بدء بيئة إنمائية محلية وتفتيشها وإيقافها وترقيتها وإعادة تعيينها |
| `doctor` | تشخيص CLI وSDK التطبيق واتصال مساحة العمل |
يقبل كل أمر يتصل بمساحة عمل `--remote \<name>` لاستهداف اتصال محفوظ غير الاتصال الافتراضي، و`--json` للحصول على مخرجات منظَّمة.
@@ -46,7 +47,7 @@ twenty auth login --url https://acme.twenty.com --use
twenty auth status
```
-استخدم عنوان مساحة عملك، أو عنوان الخادم لإعداد محلي: `http://localhost:2020` لخادم [Docker المحلي](/ar/developers/extend/apps/getting-started/local-server)، و`http://localhost:3000` لنسخة مصدرية مستخرجة. يمكنك نسخ الأمر الدقيق من **الإعدادات > المطورون > CLI**. يتطلب تسجيل الدخول عبر المتصفح Twenty 2.42 أو إصدارًا أحدث.
+استخدم عنوان مساحة العمل الخاصة بك، أو عنوان الخادم لإعداد محلي: `http://localhost:2020` لـ [بيئة التطوير المحلية](/ar/developers/extend/apps/getting-started/local-server)، و`http://localhost:3000` لنسخة مصدر مُستخرجة. يمكنك نسخ الأمر الدقيق من **الإعدادات > المطورون > CLI**. يتطلب تسجيل الدخول عبر المتصفح Twenty 2.42 أو إصدارًا أحدث.
احتفظ بعدة اتصالات عبر تسميتها:
diff --git a/packages/twenty-docs/es/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/es/developers/extend/apps/getting-started/local-server.mdx
index 3a9fe75f784..878eda9e4cf 100644
--- a/packages/twenty-docs/es/developers/extend/apps/getting-started/local-server.mdx
+++ b/packages/twenty-docs/es/developers/extend/apps/getting-started/local-server.mdx
@@ -1,38 +1,109 @@
---
-title: Servidor local
-description: Conecta la CLI independiente a un servidor Twenty local.
+title: Entorno local
+description: Ejecuta el entorno de desarrollo completo de Twenty con la CLI.
---
import { PageBanner } from "/snippets/page-banner.mdx"
-## Configuración
+## Inicia Twenty localmente
-La CLI independiente se conecta a un servidor Twenty en ejecución. No inicia ni administra contenedores de Docker.
+Instala e inicia Docker y, a continuación, ejecuta:
-Usa la [guía de autoalojamiento](/es/developers/self-host/self-host) para ejecutar Twenty con Docker. En una copia local de un repositorio de Twenty, también funciona el entorno de desarrollo existente:
+```bash
+twenty local start
+twenty auth login --url http://localhost:2020 --name local
+```
+
+`local start` ejecuta la interfaz web, la API, el worker y las bases de datos. Funciona fuera de una carpeta
+de aplicación, espera a que el entorno esté listo e imprime su URL. El inicio de sesión es un
+paso independiente. Para instalar tu aplicación después, ejecuta `twenty app apply --create --remote local` desde su directorio.
+
+Para una instancia nueva, especifica una versión explícitamente o deja que la CLI seleccione la versión publicada más alta
+que coincida con `engines.twenty` de tu aplicación. Fuera de una aplicación con esa
+configuración, usa `latest`. Las instancias existentes conservan su versión y sus datos.
+Para una instancia existente, la compatibilidad con `engines.twenty` se comprueba mediante
+la `APP_VERSION` de la imagen, incluso cuando su etiqueta es `latest`. Una versión ausente, no válida
+o incompatible genera una advertencia y el inicio continúa.
```bash
-bash packages/twenty-utils/setup-dev-env.sh
-yarn start
+twenty local start 2.53.1
+twenty local status
+twenty local logs
+twenty local logs --lines 100 --no-follow
+twenty local stop
```
-Luego autentícate con la URL del servidor de tu espacio de trabajo:
+Las instancias nuevas escuchan solo en loopback, en el puerto `2020`. Usa `--port \<port>` al
+crear una instancia para elegir otro puerto. Usa un contexto de socket local de Docker;
+los motores Docker remotos no son compatibles con estos comandos.
+
+## Actualizar o restablecer
```bash
-twenty auth login --url http://localhost:3000 --name local
-twenty app apply --create --remote local
+twenty local upgrade 2.53.1
+```
+
+La actualización descarga la imagen solicitada antes de reemplazar la instancia. Conserva
+sus puertos, la base de datos y los volúmenes de archivos, así como las anulaciones de entorno. Nuevos valores predeterminados de CLI
+se aplican a las nuevas instancias creadas; las actualizaciones preservan los valores de entorno existentes.
+Sin una versión, sigue la misma selección de versión que un nuevo comienzo. Almacenamiento personalizado
+diseños rechazados. Los niveles bajos son rechazados antes de reemplazar el contenedor,
+incluyendo al usar una etiqueta como `latest`. Ambas imágenes deben declarar una
+`APP_VERSION` válida para que la CLI pueda comparar sus versiones reales.
+
+Pase `2.53` para iniciar o actualizar usando la etiqueta de imagen `v2.53` flotante, o `2.53.1`
+para seleccionar una versión de parche específica.
+
+Si la creación de reemplazo falla o se cancela, la CLI
+restaura el contenedor y ajustes anteriores. Una vez que se inicia la nueva versión,
+actualizaciones fallidas retienen los volúmenes de datos pero no deshacen las migraciones de la base de datos.
+
+`stop` conserva todos los datos. Para eliminar permanentemente la instancia y sus datos, ejecutar:
+
+```bash
+twenty local reset
+twenty local start
```
-Usa la URL y el puerto reales de tu servidor. Para espacios de trabajo con subdominios, usa el nombre de host del espacio de trabajo.
+Reiniciar solicitud de confirmación. Los scripts deben pasar `--yes`. Los mandos guardados y las credenciales
+no se eliminan.
## Pruebas de integración
-Usa un servidor o espacio de trabajo independiente y desechable. La configuración de las pruebas de integración instala una aplicación y el desmontaje la desinstala. Configura `TWENTY_API_URL` y `TWENTY_API_KEY` para esa instancia de prueba antes de ejecutar `yarn test`.
+Usa la instancia de prueba independiente, con el puerto predeterminado `2021`:
+
+```bash
+twenty local start --test
+twenty local status --test
+TWENTY_API_URL=http://localhost:2021 yarn test
+```
+
+Configura `TWENTY_API_KEY` con una clave para esa instancia. Las pruebas de integración instalan y
+desinstalan una aplicación, así que mantenlas separadas de tu espacio de trabajo de desarrollo.
+Pasa `--test` a los registros, detener, actualizar o reiniciar al administrar esta instancia.
+
+El workflow de CI generado aprovisiona una instancia aislada mediante
+`twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` e instala la
+CLI independiente por separado.
+
+## Otras configuraciones locales
+
+Para una copia del código fuente de Twenty, el entorno de desarrollo existente también funciona:
+
+```bash
+bash packages/twenty-utils/setup-dev-env.sh
+yarn start
+twenty auth login --url http://localhost:3000 --name local
+```
-El flujo de trabajo de CI generado aprovisiona una instancia aislada mediante `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` e instala la CLI independiente por separado.
+Usa la URL y el puerto reales de tu servidor. Para espacios de trabajo con subdominios, usa el
+nombre de host del espacio de trabajo. Para la implementación en producción, sigue la
+[guía de autoalojamiento](/es/developers/self-host/self-host).
## Dependencias del proyecto
-Instala `twenty-sdk` y `twenty-client-sdk` como dependencias del proyecto. Instala la CLI `twenty` globalmente y, luego, ejecuta `twenty app typecheck`, `twenty app build` y `twenty app apply` desde el directorio de la aplicación.
+Instala `twenty-sdk` y `twenty-client-sdk` como dependencias del proyecto. Instala la
+CLI de `twenty` globalmente y, a continuación, ejecuta `twenty app typecheck`, `twenty app build` y
+`twenty app apply` desde el directorio de la aplicación.
<PageBanner illustration="dev-self-host" />
diff --git a/packages/twenty-docs/es/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/es/developers/extend/apps/getting-started/troubleshooting.mdx
index ffd27c91c82..501c268fbb2 100644
--- a/packages/twenty-docs/es/developers/extend/apps/getting-started/troubleshooting.mdx
+++ b/packages/twenty-docs/es/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -7,7 +7,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"
## Problemas comunes
-* **Errores del servidor local**, comprueba tu entorno de desarrollo de Docker o del repositorio. La CLI independiente no administra contenedores.
+* **Errores del entorno local**, consulta `twenty local status` y `twenty local logs --no-follow`. Docker debe estar instalado y ejecutándose con un contexto de socket local. Añade `--test` para la instancia de prueba. Un inicio fallido conserva su contenedor y sus datos para el diagnóstico.
* **Versión de Node incorrecta** — Se necesita 24.5+ o 26.5+ (`engines.node: ^24.5.0 || ^26.5.1`). Compruébalo con `node -v`.
* **Falta Yarn 4** — Ejecuta `corepack enable` (en Node 26, primero `npm install -g corepack`).
* **Dependencias rotas** — `rm -rf node_modules && yarn install`.
diff --git a/packages/twenty-docs/es/developers/extend/apps/logic/credits.mdx b/packages/twenty-docs/es/developers/extend/apps/logic/credits.mdx
index e8da6f9d53f..d66c660272c 100644
--- a/packages/twenty-docs/es/developers/extend/apps/logic/credits.mdx
+++ b/packages/twenty-docs/es/developers/extend/apps/logic/credits.mdx
@@ -82,24 +82,28 @@ Cómo se cobran:
## Operaciones facturables
-Una operación es aquello por lo que cobra tu app mientras funciona. Cada entrada asigna un nombre de operación que eliges a la categoría de facturación que mide la plataforma, además de la etiqueta que se muestra a los administradores del espacio de trabajo en **Configuración > Uso**.
+Una operación es aquello por lo que cobra tu app mientras funciona. Cada entrada nombra una operación que elijas y la etiqueta que se muestra a los administradores del espacio de trabajo en **Configuración > Uso** y a ti en el gráfico de supervisión **Créditos utilizados** de tu aplicación. Opcionalmente, puede asignarse a una de las categorías de facturación de la plataforma.
```ts src/application-config.ts
billing: {
operations: {
+ enrichPerson: {
+ label: 'Person enrichment',
+ icon: 'IconUserSearch',
+ },
recordMeeting: {
operationType: 'CALL_RECORDING',
label: 'Meeting recording',
},
- summarizeMeeting: {
- operationType: 'AI_CHAT_TOKEN',
- label: 'Meeting summary',
- },
},
},
```
-`operationType` debe ser una de las categorías de facturación de la plataforma: `AI_CHAT_TOKEN`, `AI_WORKFLOW_TOKEN`, `WORKFLOW_EXECUTION`, `CODE_EXECUTION`, `WEB_SEARCH`, `CALL_RECORDING`, `EMAIL_SEND`. Determina cómo se mide el gasto y qué unidad de recuento se aplica (tokens, invocaciones, minutos); no es lo que leen los administradores. La `label` sí lo es.
+`icon` es opcional: un nombre de icono de Twenty (por ejemplo, `IconUserSearch`) que se muestra junto a la etiqueta en el desglose de créditos de tu aplicación en su página de configuración.
+
+`operationType` es opcional y su valor predeterminado es `APP_OPERATION`, la categoría dedicada a los cargos de la aplicación. Establécelo solo cuando el gasto realmente pertenezca a una de las categorías de la plataforma: `AI_CHAT_TOKEN`, `AI_WORKFLOW_TOKEN`, `WORKFLOW_EXECUTION`, `CODE_EXECUTION`, `WEB_SEARCH`, `CALL_RECORDING`, `EMAIL_SEND`, `APP_OPERATION`. Determina cómo se mide el gasto y qué unidad de recuento se aplica (tokens, invocaciones, minutos); no es lo que leen los administradores. La `label` sí lo es.
+
+`CODE_EXECUTION` es donde la plataforma mide las ejecuciones de tus propias funciones, por lo que los cargos registrados allí se mezclan con ellas; usa el valor predeterminado.
La compilación rechaza un `operationType` desconocido, una `label` vacía y un nombre usado tanto por un cargo recurrente como por una operación.
@@ -123,8 +127,8 @@ Notas:
* Declarar operaciones permite que Uso divida el gasto de tu app según aquello por lo que cobró. Una app que no declara nada se sigue informando como una sola sección bajo su nombre visible.
* Se rechaza el cobro de una operación que tu manifiesto no declara. Añádela a `billing.operations` y sincroniza.
-* Varias operaciones pueden compartir un mismo `operationType`. Dos operaciones de enriquecimiento medidas ambas como `CODE_EXECUTION` siguen mostrándose como dos secciones con etiqueta.
-* Sin `operation`, nombra directamente la categoría de facturación con `operationType`, opcionalmente con un `resourceContext` de formato libre. Las dos formas son mutuamente excluyentes: `operation` incluye la etiqueta; `operationType`, no.
+* Varias operaciones pueden compartir un mismo `operationType`. Dos operaciones de enriquecimiento, ambas medidas como `APP_OPERATION`, siguen mostrándose como dos secciones etiquetadas.
+* Sin `operation`, el cargo se registra en `APP_OPERATION` o en la categoría que indiques con `operationType`, opcionalmente con un `resourceContext` de formato libre. Las dos formas son mutuamente excluyentes: `operation` incluye la etiqueta; `operationType`, no.
* El cobro nunca hace que falle tu función. Se registra y se descarta un error de facturación, y la llamada no realiza ninguna operación fuera del tiempo de ejecución de la función lógica para que las ejecuciones locales y las pruebas no fallen.
## Comprobar antes de gastar
diff --git a/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx
index 1dfc6fc5580..f7981556788 100644
--- a/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx
+++ b/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx
@@ -33,6 +33,7 @@ Los ejemplos siguientes usan `twenty`. Anteponles `npx twenty@latest` si no la i
| `api` | Envía solicitudes REST o GraphQL sin procesar |
| `open` | Abre el espacio de trabajo en tu navegador |
| `aplicación` | Crea, compila, sincroniza, depura y desinstala aplicaciones |
+| `local` | Comienza, inspecciona, para, actualiza y reinicia un entorno de desarrollo local |
| `doctor` | Diagnostica la CLI, el SDK de aplicaciones y la conexión del espacio de trabajo |
Cada comando que se comunica con un espacio de trabajo acepta `--remote \<name>` para dirigirse a una conexión guardada distinta de la predeterminada y `--json` para obtener una salida estructurada.
@@ -46,7 +47,7 @@ twenty auth login --url https://acme.twenty.com --use
twenty auth status
```
-Usa la dirección de tu espacio de trabajo o la dirección del servidor para una configuración local: `http://localhost:2020` para el [servidor Docker local](/es/developers/extend/apps/getting-started/local-server), `http://localhost:3000` para una extracción del código fuente. Puedes copiar el comando exacto desde **Configuración > Desarrolladores > CLI**. El inicio de sesión en el navegador requiere Twenty 2.42 o una versión posterior.
+Usa la dirección de tu espacio de trabajo o la dirección del servidor para una configuración local: `http://localhost:2020` para el [entorno de desarrollo local](/es/developers/extend/apps/getting-started/local-server), `http://localhost:3000` para una copia del código fuente. Puedes copiar el comando exacto desde **Configuración > Desarrolladores > CLI**. El inicio de sesión en el navegador requiere Twenty 2.42 o una versión posterior.
Mantén varias conexiones asignándoles nombres:
diff --git a/packages/twenty-docs/it/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/it/developers/extend/apps/getting-started/local-server.mdx
index d6279cb5989..68c44ebba67 100644
--- a/packages/twenty-docs/it/developers/extend/apps/getting-started/local-server.mdx
+++ b/packages/twenty-docs/it/developers/extend/apps/getting-started/local-server.mdx
@@ -1,38 +1,109 @@
---
-title: Server locale
-description: Connetti la CLI autonoma a un server Twenty locale.
+title: Ambiente locale
+description: Esegui l'ambiente di sviluppo completo di Twenty con la CLI.
---
import { PageBanner } from "/snippets/page-banner.mdx"
-## Impostazione
+## Avvia Twenty in locale
-La CLI autonoma si connette a un server Twenty in esecuzione. Non avvia né gestisce container Docker.
+Installa e avvia Docker, quindi esegui:
-Usa la [guida all'hosting autonomo](/it/developers/self-host/self-host) per eseguire Twenty con Docker. In una copia locale del repository Twenty, funziona anche l'ambiente di sviluppo esistente:
+```bash
+twenty local start
+twenty auth login --url http://localhost:2020 --name local
+```
+
+`local start` esegue l'interfaccia web, l'API, il worker e i database. Funziona al di fuori di una cartella dell'app,
+attende che l'ambiente sia pronto e stampa il relativo URL. L'accesso è un
+passaggio separato. Per installare successivamente la tua app, esegui `twenty app apply --create --remote local` dalla relativa directory.
+
+Per una nuova istanza, specifica esplicitamente una versione oppure lascia che la CLI selezioni la versione
+pubblicata più recente corrispondente a `engines.twenty` della tua app. Al di fuori di un'app con questa
+impostazione, usa `latest`. Le istanze esistenti mantengono la propria versione e i dati.
+Per un'istanza esistente, la compatibilità con `engines.twenty` viene verificata utilizzando
+`APP_VERSION` dell'immagine, anche quando il relativo tag è `latest`. Una versione mancante, non valida
+o incompatibile genera un avviso e l'avvio continua.
```bash
-bash packages/twenty-utils/setup-dev-env.sh
-yarn start
+twenty local start 2.53.1
+twenty local status
+twenty local logs
+twenty local logs --lines 100 --no-follow
+twenty local stop
```
-Quindi autentica l'accesso tramite l'URL del server per il tuo spazio di lavoro:
+Le nuove istanze restano in ascolto solo su loopback, sulla porta `2020`. Usa `--port \<port>` durante la
+creazione di un'istanza per scegliere un'altra porta. Usa un contesto socket Docker locale;
+i motori Docker remoti non sono supportati da questi comandi.
+
+## Aggiorna o reimposta
```bash
-twenty auth login --url http://localhost:3000 --name local
-twenty app apply --create --remote local
+twenty local upgrade 2.53.1
+```
+
+L'aggiornamento scarica l'immagine richiesta prima di sostituire l'istanza. Mantiene
+le porte, il database e i volumi di file, nonché le sostituzioni dell'ambiente. Le nuove impostazioni predefinite della CLI
+si applicano alle istanze create di recente; gli aggiornamenti mantengono i valori dell'ambiente esistenti.
+Senza una versione, segue la stessa selezione della versione di un nuovo avvio. I layout di archiviazione
+personalizzati vengono rifiutati. I downgrade vengono rifiutati prima di sostituire il contenitore,
+incluso quando si usa un tag come `latest`. Entrambe le immagini devono dichiarare un valore valido di
+`APP_VERSION` affinché la CLI possa confrontare le loro versioni effettive.
+
+Passa `2.53` per avviare o aggiornare usando il tag dell'immagine mobile `v2.53`, oppure `2.53.1`
+per selezionare una versione patch specifica.
+
+Se la creazione del sostituto non riesce o viene annullata, la CLI
+ripristina il contenitore e le impostazioni precedenti. Una volta avviata la nuova versione,
+gli aggiornamenti non riusciti mantengono i volumi di dati ma non annullano le migrazioni del database.
+
+`stop` conserva tutti i dati. Per eliminare definitivamente l'istanza e i relativi dati, esegui:
+
+```bash
+twenty local reset
+twenty local start
```
-Usa l'URL e la porta effettivi del tuo server. Per gli spazi di lavoro con sottodominio, usa il nome host dello spazio di lavoro.
+Reset richiede una conferma. Gli script devono passare `--yes`. I remoti salvati e
+le credenziali non vengono rimossi.
## Test di integrazione
-Usa un server o uno spazio di lavoro separato e temporaneo. La configurazione dei test di integrazione installa un'app e la pulizia la disinstalla. Imposta `TWENTY_API_URL` e `TWENTY_API_KEY` su quell'istanza di test prima di eseguire `yarn test`.
+Usa l'istanza di test separata, porta predefinita `2021`:
+
+```bash
+twenty local start --test
+twenty local status --test
+TWENTY_API_URL=http://localhost:2021 yarn test
+```
+
+Imposta `TWENTY_API_KEY` su una chiave per quell'istanza. I test di integrazione installano e
+disinstallano un'app, quindi tienili separati dal tuo spazio di lavoro di sviluppo.
+Passa `--test` a logs, stop, upgrade o reset quando gestisci questa istanza.
+
+Il workflow CI generato effettua il provisioning di un'istanza isolata tramite
+`twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` e installa separatamente la
+CLI standalone.
+
+## Altre configurazioni locali
+
+Per un checkout del codice sorgente di Twenty, funziona anche l'ambiente di sviluppo esistente:
+
+```bash
+bash packages/twenty-utils/setup-dev-env.sh
+yarn start
+twenty auth login --url http://localhost:3000 --name local
+```
-Il workflow CI generato esegue il provisioning di un'istanza isolata tramite `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` e installa separatamente la CLI autonoma.
+Usa l'URL e la porta effettivi del tuo server. Per gli spazi di lavoro con sottodomini, usa il
+nome host dello spazio di lavoro. Per la distribuzione in produzione, segui la
+[guida all'hosting autonomo](/it/developers/self-host/self-host).
## Dipendenze del progetto
-Installa `twenty-sdk` e `twenty-client-sdk` come dipendenze del progetto. Installa la CLI `twenty` globalmente, quindi esegui `twenty app typecheck`, `twenty app build` e `twenty app apply` dalla directory dell'app.
+Installa `twenty-sdk` e `twenty-client-sdk` come dipendenze del progetto. Installa globalmente la
+CLI `twenty`, quindi esegui `twenty app typecheck`, `twenty app build` e
+`twenty app apply` dalla directory dell'app.
<PageBanner illustration="dev-self-host" />
diff --git a/packages/twenty-docs/it/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/it/developers/extend/apps/getting-started/troubleshooting.mdx
index 3e4292bdad9..060df13eedd 100644
--- a/packages/twenty-docs/it/developers/extend/apps/getting-started/troubleshooting.mdx
+++ b/packages/twenty-docs/it/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -7,7 +7,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"
## Problemi comuni
-* **Errori del server locale**, controlla l'ambiente di sviluppo Docker o del repository. La CLI standalone non gestisce i container.
+* **Errori dell'ambiente locale**, controlla `twenty local status` e `twenty local logs --no-follow`. Docker deve essere installato e in esecuzione con un contesto socket locale. Aggiungi `--test` per l'istanza di test. Un avvio non riuscito conserva il relativo container e i dati per la diagnosi.
* **Versione di Node errata** — È necessaria la versione 24.5+ o 26.5+ (`engines.node: ^24.5.0 || ^26.5.1`). Verifica con `node -v`.
* **Yarn 4 mancante** — Esegui `corepack enable` (su Node 26, prima `npm install -g corepack`).
* **Dipendenze danneggiate** — `rm -rf node_modules && yarn install`.
diff --git a/packages/twenty-docs/it/developers/extend/apps/logic/credits.mdx b/packages/twenty-docs/it/developers/extend/apps/logic/credits.mdx
index fc14fda90bc..89c6dfa903c 100644
--- a/packages/twenty-docs/it/developers/extend/apps/logic/credits.mdx
+++ b/packages/twenty-docs/it/developers/extend/apps/logic/credits.mdx
@@ -82,24 +82,28 @@ Modalità di applicazione:
## Operazioni fatturabili
-Un'operazione è ciò per cui la tua app addebita mentre funziona. Ogni voce associa un nome di operazione scelto da te alla categoria di fatturazione misurata dalla piattaforma, oltre all'etichetta mostrata agli amministratori del workspace in **Impostazioni > Utilizzo**.
+Un'operazione è ciò per cui la tua app addebita mentre funziona. Ogni voce denomina un'operazione scelta da te e l'etichetta mostrata agli amministratori dello spazio di lavoro in **Impostazioni > Utilizzo** e a te nel grafico di monitoraggio **Crediti utilizzati** della tua app. Facoltativamente, può essere associata a una delle categorie di fatturazione della piattaforma.
```ts src/application-config.ts
billing: {
operations: {
+ enrichPerson: {
+ label: 'Person enrichment',
+ icon: 'IconUserSearch',
+ },
recordMeeting: {
operationType: 'CALL_RECORDING',
label: 'Meeting recording',
},
- summarizeMeeting: {
- operationType: 'AI_CHAT_TOKEN',
- label: 'Meeting summary',
- },
},
},
```
-`operationType` deve essere una delle categorie di fatturazione della piattaforma: `AI_CHAT_TOKEN`, `AI_WORKFLOW_TOKEN`, `WORKFLOW_EXECUTION`, `CODE_EXECUTION`, `WEB_SEARCH`, `CALL_RECORDING`, `EMAIL_SEND`. Determina il modo in cui la spesa viene misurata e quale unità di conteggio si applica (token, invocazioni, minuti), ma non è ciò che leggono gli amministratori. Lo è `label`.
+`icon` è facoltativo: un nome di icona Twenty (ad es. `IconUserSearch`) visualizzato accanto all'etichetta nella ripartizione dei crediti della tua app nella relativa pagina delle impostazioni.
+
+`operationType` è facoltativo e per impostazione predefinita è `APP_OPERATION`, la categoria dedicata agli addebiti delle app. Impostalo solo quando la spesa rientra effettivamente in una delle categorie della piattaforma: `AI_CHAT_TOKEN`, `AI_WORKFLOW_TOKEN`, `WORKFLOW_EXECUTION`, `CODE_EXECUTION`, `WEB_SEARCH`, `CALL_RECORDING`, `EMAIL_SEND`, `APP_OPERATION`. Determina il modo in cui la spesa viene misurata e quale unità di conteggio si applica (token, invocazioni, minuti), ma non è ciò che leggono gli amministratori. Lo è `label`.
+
+`CODE_EXECUTION` è il punto in cui la piattaforma contabilizza le esecuzioni delle tue funzioni, quindi gli addebiti registrati lì vengono mescolati con esse; preferisci l'impostazione predefinita.
La build rifiuta un `operationType` sconosciuto, un `label` vuoto e un nome utilizzato sia da un addebito ricorrente sia da un'operazione.
@@ -123,8 +127,8 @@ Note:
* La dichiarazione delle operazioni consente a Utilizzo di suddividere la spesa della tua app in base a ciò per cui ha addebitato. Un'app che non dichiara nulla viene comunque riportata come un'unica sezione sotto il suo nome visualizzato.
* L'addebito di un'operazione non dichiarata dal tuo manifest viene rifiutato. Aggiungila a `billing.operations` e sincronizza.
-* Più operazioni possono condividere uno stesso `operationType`. Due operazioni di arricchimento, entrambe misurate come `CODE_EXECUTION`, vengono comunque visualizzate come due sezioni etichettate.
-* Senza `operation`, indica direttamente la categoria di fatturazione con `operationType`, facoltativamente con un `resourceContext` in formato libero. Le due forme si escludono a vicenda: `operation` contiene l'etichetta, `operationType` no.
+* Più operazioni possono condividere uno stesso `operationType`. Due operazioni di arricchimento, entrambe contabilizzate come `APP_OPERATION`, vengono comunque visualizzate come due segmenti etichettati.
+* Senza `operation`, l'addebito confluisce in `APP_OPERATION`, o nella categoria specificata con `operationType`, facoltativamente con un `resourceContext` in formato libero. Le due forme si escludono a vicenda: `operation` contiene l'etichetta, `operationType` no.
* L'addebito non fa mai fallire la tua funzione. Un errore di fatturazione viene registrato e ignorato, e la chiamata non esegue alcuna operazione al di fuori del runtime della funzione di logica, affinché le esecuzioni locali e i test non si arrestino in modo anomalo.
## Verificare prima di spendere
diff --git a/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx
index 31646cb9daf..c60b1389b56 100644
--- a/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx
+++ b/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx
@@ -24,16 +24,17 @@ twenty --version
Gli esempi seguenti usano `twenty`. Aggiungi il prefisso `npx twenty@latest` se non l'hai installata globalmente. Esegui `twenty commands` per l'elenco completo dei comandi e `twenty \<command> --help` per le opzioni di un comando.
-| Comando | Cosa fa |
-| ---------------- | ---------------------------------------------------------------------------------- |
-| `autenticazione` | Accedi, verifica e rimuovi le credenziali |
-| `remote` | Elenca, seleziona, rinomina e rimuovi le connessioni salvate allo spazio di lavoro |
-| `metadati` | Ispeziona oggetti e campi |
-| `data` | Elenca e leggi i record |
-| `api` | Invia richieste REST o GraphQL non elaborate |
-| `apri` | Apri lo spazio di lavoro nel browser |
-| `app` | Crea, compila, sincronizza, esegui il debug e disinstalla app |
-| `doctor` | Diagnostica la CLI, l'SDK dell'app e la connessione allo spazio di lavoro |
+| Comando | Cosa fa |
+| ---------------- | --------------------------------------------------------------------------------------- |
+| `autenticazione` | Accedi, verifica e rimuovi le credenziali |
+| `remote` | Elenca, seleziona, rinomina e rimuovi le connessioni salvate allo spazio di lavoro |
+| `metadati` | Ispeziona oggetti e campi |
+| `data` | Elenca e leggi i record |
+| `api` | Invia richieste REST o GraphQL non elaborate |
+| `apri` | Apri lo spazio di lavoro nel browser |
+| `app` | Crea, compila, sincronizza, esegui il debug e disinstalla app |
+| `locale` | Avviare, ispezionare, fermare, aggiornare e ripristinare un ambiente di sviluppo locale |
+| `doctor` | Diagnostica la CLI, l'SDK dell'app e la connessione allo spazio di lavoro |
Ogni comando che comunica con uno spazio di lavoro accetta `--remote \<name>` per indirizzare una connessione salvata diversa da quella predefinita e `--json` per un output strutturato.
@@ -46,7 +47,7 @@ twenty auth login --url https://acme.twenty.com --use
twenty auth status
```
-Usa l'indirizzo del tuo spazio di lavoro o l'indirizzo del server per una configurazione locale: `http://localhost:2020` per il [server Docker locale](/it/developers/extend/apps/getting-started/local-server), `http://localhost:3000` per un checkout del codice sorgente. Puoi copiare il comando esatto da **Settings > Developers > CLI**. L'accesso tramite browser richiede Twenty 2.42 o versioni successive.
+Usa l'indirizzo del tuo spazio di lavoro, oppure l'indirizzo del server per una configurazione locale: `http://localhost:2020` per l'[ambiente di sviluppo locale](/it/developers/extend/apps/getting-started/local-server), `http://localhost:3000` per un checkout del codice sorgente. Puoi copiare il comando esatto da **Settings > Developers > CLI**. L'accesso tramite browser richiede Twenty 2.42 o versioni successive.
Mantieni diverse connessioni assegnando loro un nome:
diff --git a/packages/twenty-docs/ro/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/ro/developers/extend/apps/getting-started/local-server.mdx
index fafd1e4483d..e9aa9cc0bfb 100644
--- a/packages/twenty-docs/ro/developers/extend/apps/getting-started/local-server.mdx
+++ b/packages/twenty-docs/ro/developers/extend/apps/getting-started/local-server.mdx
@@ -1,38 +1,109 @@
---
-title: Server local
-description: Conectați CLI-ul autonom la un server Twenty local.
+title: Mediu local
+description: Rulați mediul complet de dezvoltare Twenty cu CLI-ul.
---
import { PageBanner } from "/snippets/page-banner.mdx"
-## Configurare
+## Porniți Twenty local
-CLI-ul autonom se conectează la un server Twenty care rulează. Nu pornește și nu gestionează containere Docker.
+Instalați și porniți Docker, apoi rulați:
-Utilizați [ghidul de auto-găzduire](/ro/developers/self-host/self-host) pentru a rula Twenty cu Docker. Într-un checkout al depozitului Twenty, funcționează și mediul de dezvoltare existent:
+```bash
+twenty local start
+twenty auth login --url http://localhost:2020 --name local
+```
+
+`local start` pornește interfața web, API-ul, workerul și bazele de date. Funcționează în afara unui director de aplicație,
+așteaptă ca mediul să fie gata și îi afișează URL-ul. Autentificarea este un
+pas separat. Pentru a instala ulterior aplicația, rulați `twenty app apply --create --remote local` din directorul acesteia.
+
+Pentru o instanță nouă, specificați explicit o versiune sau lăsați CLI-ul să selecteze cea mai mare
+versiune publicată care corespunde cu `engines.twenty` al aplicației. În afara unei aplicații cu această
+setare, utilizează `latest`. Instanțele existente își păstrează versiunea și datele.
+Pentru o instanță existentă, compatibilitatea cu `engines.twenty` este verificată folosind
+`APP_VERSION` al imaginii, inclusiv atunci când eticheta acesteia este `latest`. O versiune lipsă, nevalidă
+sau incompatibilă generează un avertisment, iar pornirea continuă.
```bash
-bash packages/twenty-utils/setup-dev-env.sh
-yarn start
+twenty local start 2.53.1
+twenty local status
+twenty local logs
+twenty local logs --lines 100 --no-follow
+twenty local stop
```
-Apoi autentificați-vă la URL-ul serverului pentru spațiul dvs. de lucru:
+Instanțele noi ascultă numai pe loopback, pe portul `2020`. Utilizați `--port \<port>` când
+creați o instanță pentru a alege alt port. Utilizați un context local pentru socket Docker;
+motoarele Docker la distanță nu sunt acceptate de aceste comenzi.
+
+## Faceți upgrade sau resetați
```bash
-twenty auth login --url http://localhost:3000 --name local
-twenty app apply --create --remote local
+twenty local upgrade 2.53.1
+```
+
+Upgrade-ul extrage imaginea solicitată înainte de a înlocui instanța. Acesta păstrează
+porturile, baza de date și volumele de fișiere, precum și suprascrierile de mediu. Noi valori implicite ale CLI
+se aplică noilor instanțe; upgrade-urile păstrează valorile de mediu existente.
+Fără o versiune, urmează aceeași selecție de versiune ca un nou început. Depozitul personalizat
+este respins. Downgrade sunt respinse înainte de a înlocui containerul,
+inclusiv când se folosește o etichetă precum `latest`. Ambele imagini trebuie să declare un
+valid `APP_VERSION` astfel încât CLI să poată compara versiunile lor reale.
+
+Treceți `2.53` să începeți sau să faceți upgrade folosind eticheta de imagine `v2.53` plutitoare, sau `2.53.1`
+pentru a selecta o versiune specifică a patch-ului.
+
+În cazul în care crearea înlocuirii eșuează sau este anulată, CLI
+restaurează containerul anterior și setările. Odată ce noua versiune începe,
+a eșuat actualizarea reține volumele de date dar nu redirecționează migrațiile bazei de date înapoi.
+
+`stop` păstrează toate datele. Pentru a șterge definitiv instanța și datele acesteia, executați:
+
+```bash
+twenty local reset
+twenty local start
```
-Utilizați URL-ul și portul efective ale serverului dvs. Pentru spațiile de lucru cu subdomenii, utilizați numele de gazdă al spațiului de lucru.
+Resetarea cere confirmare. Scripturile trebuie să treacă de `--yes`. Credențialele de la telecomenzi salvate și
+nu sunt șterse.
## Teste de integrare
-Utilizați un server sau un spațiu de lucru separat, care poate fi eliminat. Configurarea testelor de integrare instalează o aplicație, iar etapa de curățare o dezinstalează. Setați `TWENTY_API_URL` și `TWENTY_API_KEY` la acea instanță de test înainte de a rula `yarn test`.
+Utilizați instanța de test separată, cu portul implicit `2021`:
+
+```bash
+twenty local start --test
+twenty local status --test
+TWENTY_API_URL=http://localhost:2021 yarn test
+```
+
+Setați `TWENTY_API_KEY` la o cheie pentru acea instanță. Testele de integrare instalează și
+dezinstalează o aplicație, așa că păstrați-le separate de spațiul dvs. de lucru pentru dezvoltare.
+Treceți `--test` la jurnale, opriți, upgradați sau resetați când gestionați această instanță.
+
+Fluxul de lucru CI generat configurează o instanță izolată prin
+`twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` și instalează separat
+CLI-ul independent.
+
+## Alte configurări locale
+
+Pentru un checkout al codului-sursă Twenty, funcționează și mediul de dezvoltare existent:
+
+```bash
+bash packages/twenty-utils/setup-dev-env.sh
+yarn start
+twenty auth login --url http://localhost:3000 --name local
+```
-Fluxul de lucru CI generat configurează o instanță izolată prin `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` și instalează separat CLI-ul autonom.
+Utilizați URL-ul și portul efective ale serverului dvs. Pentru spațiile de lucru cu subdomenii, utilizați
+numele de gazdă al spațiului de lucru. Pentru implementarea în producție, urmați
+[ghidul de auto-găzduire](/ro/developers/self-host/self-host).
## Dependențele proiectului
-Instalați `twenty-sdk` și `twenty-client-sdk` ca dependențe ale proiectului. Instalați CLI-ul `twenty` global, apoi rulați `twenty app typecheck`, `twenty app build` și `twenty app apply` din directorul aplicației.
+Instalați `twenty-sdk` și `twenty-client-sdk` ca dependențe ale proiectului. Instalați
+CLI-ul `twenty` la nivel global, apoi rulați `twenty app typecheck`, `twenty app build` și
+`twenty app apply` din directorul aplicației.
<PageBanner illustration="dev-self-host" />
diff --git a/packages/twenty-docs/ro/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/ro/developers/extend/apps/getting-started/troubleshooting.mdx
index 09d3384f80f..47b1458129e 100644
--- a/packages/twenty-docs/ro/developers/extend/apps/getting-started/troubleshooting.mdx
+++ b/packages/twenty-docs/ro/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -7,7 +7,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"
## Probleme comune
-* **Erori ale serverului local**, verificați mediul de dezvoltare Docker sau al depozitului. CLI-ul autonom nu gestionează containere.
+* **Erori de mediu local**, verifică `twenty local status` și `twenty local logs --no-follow`. Docker trebuie să fie instalat și să ruleze cu un context de socket local. Adaugă `--test` pentru instanța de test. O pornire eșuată păstrează containerul și datele sale pentru diagnosticare.
* **Versiune Node greșită** — Este necesară versiunea 24.5+ sau 26.5+ (`engines.node: ^24.5.0 || ^26.5.1`). Verificați cu `node -v`.
* **Yarn 4 lipsește** — Rulați `corepack enable` (pe Node 26, mai întâi `npm install -g corepack`).
* **Dependențe nefuncționale** — `rm -rf node_modules && yarn install`.
diff --git a/packages/twenty-docs/ro/developers/extend/apps/logic/credits.mdx b/packages/twenty-docs/ro/developers/extend/apps/logic/credits.mdx
index b1a8809d133..c9f4102857c 100644
--- a/packages/twenty-docs/ro/developers/extend/apps/logic/credits.mdx
+++ b/packages/twenty-docs/ro/developers/extend/apps/logic/credits.mdx
@@ -82,24 +82,28 @@ Cum sunt aplicate:
## Operațiuni facturabile
-O operațiune este ceea ce taxează aplicația dvs. pe măsură ce funcționează. Fiecare intrare asociază un nume de operațiune ales de dvs. cu categoria de facturare pe care platforma o contorizează, plus eticheta afișată administratorilor spațiului de lucru în **Setări > Utilizare**.
+O operațiune este ceea ce taxează aplicația dvs. pe măsură ce funcționează. Fiecare intrare denumește o operațiune pe care o alegeți și eticheta afișată administratorilor spațiului de lucru în **Settings > Usage** și vouă în graficul **Credits used** de monitorizare al aplicației voastre. Opțional, se poate mapa la una dintre categoriile de facturare ale platformei.
```ts src/application-config.ts
billing: {
operations: {
+ enrichPerson: {
+ label: 'Person enrichment',
+ icon: 'IconUserSearch',
+ },
recordMeeting: {
operationType: 'CALL_RECORDING',
label: 'Meeting recording',
},
- summarizeMeeting: {
- operationType: 'AI_CHAT_TOKEN',
- label: 'Meeting summary',
- },
},
},
```
-`operationType` trebuie să fie una dintre categoriile de facturare ale platformei: `AI_CHAT_TOKEN`, `AI_WORKFLOW_TOKEN`, `WORKFLOW_EXECUTION`, `CODE_EXECUTION`, `WEB_SEARCH`, `CALL_RECORDING`, `EMAIL_SEND`. Aceasta decide cum este contorizată cheltuiala și ce unitate de numărare se aplică (tokenuri, invocări, minute) — nu este ceea ce citesc administratorii. `label` este.
+`icon` este opțional: un nume de pictogramă Twenty (de exemplu, `IconUserSearch`) afișat lângă etichetă în defalcarea creditelor aplicației voastre, pe pagina sa de setări.
+
+`operationType` este opțional și are ca valoare implicită `APP_OPERATION`, categoria dedicată pentru taxele aplicației. Setați-l numai atunci când cheltuiala aparține într-adevăr uneia dintre categoriile platformei: `AI_CHAT_TOKEN`, `AI_WORKFLOW_TOKEN`, `WORKFLOW_EXECUTION`, `CODE_EXECUTION`, `WEB_SEARCH`, `CALL_RECORDING`, `EMAIL_SEND`, `APP_OPERATION`. Aceasta decide cum este contorizată cheltuiala și ce unitate de numărare se aplică (tokenuri, invocări, minute) — nu este ceea ce citesc administratorii. `label` este.
+
+`CODE_EXECUTION` este locul în care platforma contorizează propriile execuții ale funcțiilor dvs., astfel încât taxele înregistrate acolo sunt combinate cu acestea; preferați valoarea implicită.
Compilarea respinge un `operationType` necunoscut, un `label` gol și un nume utilizat atât de o taxă recurentă, cât și de o operațiune.
@@ -123,8 +127,8 @@ Notițe:
* Declararea operațiunilor permite ca Utilizare să împartă cheltuiala aplicației dvs. în funcție de ceea ce a taxat. O aplicație care nu declară nimic este totuși raportată, ca o singură secțiune sub numele său afișat.
* Taxarea unei operațiuni pe care manifestul dvs. nu o declară este respinsă. Adăugați-o la `billing.operations` și sincronizați.
-* Mai multe operațiuni pot partaja un singur `operationType`. Două operațiuni de îmbogățire contorizate ambele ca `CODE_EXECUTION` sunt în continuare afișate ca două secțiuni etichetate.
-* Fără `operation`, numiți direct categoria de facturare cu `operationType`, opțional cu un `resourceContext` în formă liberă. Cele două forme se exclud reciproc: `operation` conține eticheta, `operationType` nu.
+* Mai multe operațiuni pot partaja un singur `operationType`. Două operațiuni de îmbogățire, ambele contorizate ca `APP_OPERATION`, apar în continuare ca două segmente etichetate.
+* Fără `operation`, taxa este încadrată în `APP_OPERATION` sau în categoria pe care o denumiți cu `operationType`, opțional cu un `resourceContext` în format liber. Cele două forme se exclud reciproc: `operation` conține eticheta, `operationType` nu.
* Taxarea nu face niciodată ca funcția dvs. să eșueze. O eroare de facturare este înregistrată și ignorată, iar apelul nu face nimic în afara mediului de rulare al funcției logice, astfel încât rulările locale și testele să nu se blocheze.
## Verificarea înainte de a cheltui
diff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx
index 28a0de5e17b..36957379c8d 100644
--- a/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx
+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx
@@ -33,6 +33,7 @@ Exemplele de mai jos folosesc `twenty`. Prefixați-le cu `npx twenty@latest` dac
| `api` | Trimiteți cereri REST sau GraphQL brute |
| `open` | Deschideți spațiul de lucru în browser |
| `aplicație` | Creați, compilați, sincronizați, depanați și dezinstalați aplicații |
+| `local` | Începeți, inspectați, opriți, actualizați și resetați mediul de dezvoltare locală |
| `doctor` | Diagnosticați CLI-ul, SDK-ul aplicației și conexiunea la spațiul de lucru |
Fiecare comandă care comunică cu un spațiu de lucru acceptă `--remote \<name>` pentru a viza o conexiune salvată alta decât cea implicită și `--json` pentru ieșire structurată.
@@ -46,7 +47,7 @@ twenty auth login --url https://acme.twenty.com --use
twenty auth status
```
-Utilizați adresa spațiului de lucru sau adresa serverului pentru o configurare locală: `http://localhost:2020` pentru [serverul Docker local](/ro/developers/extend/apps/getting-started/local-server), `http://localhost:3000` pentru o copie locală a sursei. Puteți copia comanda exactă din **Settings > Developers > CLI**. Autentificarea prin browser necesită Twenty 2.42 sau o versiune ulterioară.
+Utilizați adresa spațiului dvs. de lucru sau adresa serverului pentru o configurare locală: `http://localhost:2020` pentru [mediul de dezvoltare local](/ro/developers/extend/apps/getting-started/local-server), `http://localhost:3000` pentru o copie locală a codului sursă. Puteți copia comanda exactă din **Settings > Developers > CLI**. Autentificarea prin browser necesită Twenty 2.42 sau o versiune ulterioară.
Păstrați mai multe conexiuni denumindu-le:
diff --git a/packages/twenty-docs/ru/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/ru/developers/extend/apps/getting-started/local-server.mdx
index c258aa31f09..3da9482b1be 100644
--- a/packages/twenty-docs/ru/developers/extend/apps/getting-started/local-server.mdx
+++ b/packages/twenty-docs/ru/developers/extend/apps/getting-started/local-server.mdx
@@ -1,38 +1,109 @@
---
-title: Локальный сервер
-description: Подключите автономный CLI к локальному серверу Twenty.
+title: Локальная среда разработки
+description: Запустите полную среду разработки Twenty с помощью CLI.
---
import { PageBanner } from "/snippets/page-banner.mdx"
-## Настройка
+## Запустите Twenty локально
-Автономный CLI подключается к запущенному серверу Twenty. Он не запускает контейнеры Docker и не управляет ими.
+Установите и запустите Docker, затем выполните:
-Используйте [руководство по самостоятельному хостингу](/ru/developers/self-host/self-host), чтобы запустить Twenty с Docker. В рабочей копии репозитория Twenty также работает существующая среда разработки:
+```bash
+twenty local start
+twenty auth login --url http://localhost:2020 --name local
+```
+
+`local start` запускает веб-интерфейс, API, воркер и базы данных. Она работает вне папки приложения,
+ожидает готовности среды и выводит её URL-адрес. Вход — это
+отдельный шаг. Чтобы затем установить приложение, выполните `twenty app apply --create --remote local` из его каталога.
+
+Для нового экземпляра явно укажите версию или позвольте CLI выбрать самую высокую
+опубликованную версию, соответствующую `engines.twenty` вашего приложения. Вне приложения с этой
+настройкой используется `latest`. Существующие экземпляры сохраняют свою версию и данные.
+Для существующего экземпляра совместимость с `engines.twenty` проверяется с помощью
+`APP_VERSION` образа, в том числе если его тег — `latest`. Отсутствующая, недопустимая
+или несовместимая версия вызывает предупреждение, а запуск продолжается.
```bash
-bash packages/twenty-utils/setup-dev-env.sh
-yarn start
+twenty local start 2.53.1
+twenty local status
+twenty local logs
+twenty local logs --lines 100 --no-follow
+twenty local stop
```
-Затем пройдите аутентификацию на URL-адресе сервера для вашего рабочего пространства:
+Новые экземпляры принимают подключения только через loopback, на порту `2020`. При создании экземпляра используйте `--port \<port>`, чтобы
+выбрать другой порт. Используйте контекст локального сокета Docker;
+удалённые движки Docker не поддерживаются этими командами.
+
+## Обновить или сбросить
```bash
-twenty auth login --url http://localhost:3000 --name local
-twenty app apply --create --remote local
+twenty local upgrade 2.53.1
+```
+
+При обновлении запрашиваемый образ загружается перед заменой экземпляра. При этом сохраняются
+его порты, база данных и файловые тома, а также переопределения окружения. Новые значения CLI по умолчанию
+применяются к вновь созданным экземплярам; обновляет сохранение существующих значений среды.
+Без версии она следует тому же выбору версий, что и новый старт. Пользовательские конфигурации
+хранилища отклоняются. Понижения отвергаются перед заменой контейнера,
+в том числе при использовании тега, такого как `latest`. Оба изображения должны объявить действительными
+`APP_VERSION`, чтобы CLI мог сравнить их фактические версии.
+
+Передайте `2.53` для запуска или обновления с помощью тега с плавающей плавающей `v2.53` или `2.53.1`
+для выбора конкретной версии патча.
+
+Если создание не выполнено или отменено, CLI
+восстанавливает предыдущий контейнер и настройки. Как только начнется новая версия,
+неудачные обновления сохраняют объемы данных, но не откатывают обратно базы данных.
+
+`stop` сохраняет все данные. Чтобы навсегда удалить экземпляр и его данные, запустите:
+
+```bash
+twenty local reset
+twenty local start
```
-Используйте фактический URL-адрес и порт вашего сервера. Для рабочих пространств с поддоменами используйте имя хоста рабочего пространства.
+Сброс запросов для подтверждения. Скрипты должны пройти `--yes`. Сохраненные удаленные репозитории и
+учетные данные не удаляются.
## Интеграционные тесты
-Используйте отдельный временный сервер или рабочее пространство. Настройка интеграционного теста устанавливает приложение, а очистка удаляет его. Перед запуском `yarn test` задайте для этого тестового экземпляра `TWENTY_API_URL` и `TWENTY_API_KEY`.
+Используйте отдельный тестовый экземпляр с портом по умолчанию `2021`:
+
+```bash
+twenty local start --test
+twenty local status --test
+TWENTY_API_URL=http://localhost:2021 yarn test
+```
+
+Установите для `TWENTY_API_KEY` ключ этого экземпляра. Интеграционные тесты устанавливают и
+удаляют приложение, поэтому не используйте их в одной среде разработки.
+Передайте `--test` в журналы, остановить, обновить или сбросить при управлении этим экземпляром.
+
+Созданный рабочий процесс CI подготавливает изолированный экземпляр через
+`twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` и отдельно устанавливает
+автономный CLI.
+
+## Другие локальные конфигурации
+
+Для исходной копии Twenty также подходит существующая среда разработки:
+
+```bash
+bash packages/twenty-utils/setup-dev-env.sh
+yarn start
+twenty auth login --url http://localhost:3000 --name local
+```
-Сгенерированный рабочий процесс CI разворачивает изолированный экземпляр через `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main` и отдельно устанавливает автономный CLI.
+Используйте фактический URL-адрес и порт вашего сервера. Для рабочих пространств с поддоменами используйте
+имя хоста рабочего пространства. Для развёртывания в производственной среде следуйте
+[руководству по самостоятельному хостингу](/ru/developers/self-host/self-host).
## Зависимости проекта
-Установите `twenty-sdk` и `twenty-client-sdk` в качестве зависимостей проекта. Установите CLI `twenty` глобально, затем выполните `twenty app typecheck`, `twenty app build` и `twenty app apply` из каталога приложения.
+Установите `twenty-sdk` и `twenty-client-sdk` в качестве зависимостей проекта. Установите
+CLI `twenty` глобально, затем выполните `twenty app typecheck`, `twenty app build` и
+`twenty app apply` из каталога приложения.
<PageBanner illustration="dev-self-host" />
diff --git a/packages/twenty-docs/ru/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/ru/developers/extend/apps/getting-started/troubleshooting.mdx
index 7bd395c1b23..b969be42009 100644
--- a/packages/twenty-docs/ru/developers/extend/apps/getting-started/troubleshooting.mdx
+++ b/packages/twenty-docs/ru/developers/extend/apps/getting-started/troubleshooting.mdx
@@ -7,7 +7,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"
## Распространённые проблемы
-* **Ошибки локального сервера**: проверьте среду разработки Docker или репозитория. Автономный CLI не управляет контейнерами.
+* **Ошибки локальной среды**, проверьте `twenty local status` и `twenty local logs --no-follow`. Docker должен быть установлен и запущен с контекстом локального сокета. Добавьте `--test` для тестового экземпляра. При неудачном запуске его контейнер и данные сохраняются для диагностики.
* **Неверная версия Node** — требуется 24.5+ или 26.5+ (`engines.node: ^24.5.0 || ^26.5.1`). Проверьте с помощью `node -v`.
* **Yarn 4 отсутствует** — выполните `corepack enable` (в Node 26 сначала выполните `npm install -g corepack`).
* **Зависимости повреждены** — `rm -rf node_modules && yarn install`.
diff --git a/packages/twenty-docs/ru/developers/extend/apps/logic/credits.mdx b/packages/twenty-docs/ru/developers/extend/apps/logic/credits.mdx
index 279bf6163c3..e2e546bf8c0 100644
--- a/packages/twenty-docs/ru/developers/extend/apps/logic/credits.mdx
+++ b/packages/twenty-docs/ru/developers/extend/apps/logic/credits.mdx
@@ -82,24 +82,28 @@ billing: {
## Платные операции
-Операция — это то, за что ваше приложение взимает плату во время работы. Каждая запись сопоставляет выбранное вами имя операции с категорией выставления счетов, которую учитывает платформа, а также с меткой, показываемой администраторам рабочей области в **Настройки > Использование**.
+Операция — это то, за что ваше приложение взимает плату во время работы. Каждая запись задает выбранную вами операцию и метку, отображаемую администраторам рабочего пространства в **Настройки > Использование** и вам на диаграмме **Использованные кредиты** в мониторинге вашего приложения. При необходимости ее можно сопоставить с одной из категорий выставления счетов платформы.
```ts src/application-config.ts
billing: {
operations: {
+ enrichPerson: {
+ label: 'Person enrichment',
+ icon: 'IconUserSearch',
+ },
recordMeeting: {
operationType: 'CALL_RECORDING',
label: 'Meeting recording',
},
- summarizeMeeting: {
- operationType: 'AI_CHAT_TOKEN',
- label: 'Meeting summary',
- },
},
},
```
-`operationType` должен быть одной из категорий выставления счетов платформы: `AI_CHAT_TOKEN`, `AI_WORKFLOW_TOKEN`, `WORKFLOW_EXECUTION`, `CODE_EXECUTION`, `WEB_SEARCH`, `CALL_RECORDING`, `EMAIL_SEND`. Он определяет, как учитываются расходы и какая единица подсчёта применяется (токены, вызовы, минуты), — это не то, что видят администраторы. Для этого используется `label`.
+`icon` является необязательным: имя значка Twenty (например, `IconUserSearch`), отображаемого рядом с меткой в разбивке кредитов вашего приложения на странице его настроек.
+
+`operationType` является необязательным и по умолчанию имеет значение `APP_OPERATION` — специальной категории для списаний приложения. Устанавливайте его, только если расход действительно относится к одной из категорий платформы: `AI_CHAT_TOKEN`, `AI_WORKFLOW_TOKEN`, `WORKFLOW_EXECUTION`, `CODE_EXECUTION`, `WEB_SEARCH`, `CALL_RECORDING`, `EMAIL_SEND`, `APP_OPERATION`. Он определяет, как учитываются расходы и какая единица подсчёта применяется (токены, вызовы, минуты), — это не то, что видят администраторы. Для этого используется `label`.
+
+`CODE_EXECUTION` — это место, где платформа тарифицирует собственные запуски ваших функций, поэтому начисления в этой категории смешиваются с ними; используйте значение по умолчанию.
Сборка отклоняет неизвестный `operationType`, пустой `label` и имя, используемое одновременно для регулярного списания и операции.
@@ -123,8 +127,8 @@ await chargeCredits({
* Объявление операций позволяет разделять в разделе «Использование» расходы вашего приложения по тому, за что оно взимало плату. Приложение, которое ничего не объявляет, всё равно отображается как один сегмент под своим отображаемым именем.
* Списание за операцию, не объявленную в вашем манифесте, отклоняется. Добавьте её в `billing.operations` и синхронизируйте.
-* Несколько операций могут использовать один `operationType`. Две операции обогащения данных, учитываемые как `CODE_EXECUTION`, всё равно отображаются как два сегмента с метками.
-* Без `operation` укажите категорию выставления счетов напрямую с помощью `operationType`, при необходимости добавив произвольный `resourceContext`. Эти две формы взаимоисключающие: `operation` содержит метку, а `operationType` — нет.
+* Несколько операций могут использовать один `operationType`. Две операции обогащения, тарифицируемые как `APP_OPERATION`, по-прежнему отображаются как два помеченных сегмента.
+* Без `operation` начисление относится к `APP_OPERATION` или к категории, указанной с помощью `operationType`, при необходимости с произвольным `resourceContext`. Эти две формы взаимоисключающие: `operation` содержит метку, а `operationType` — нет.
* Списание никогда не приводит к сбою вашей функции. Ошибка выставления счетов регистрируется и игнорируется, а вызов ничего не делает вне среды выполнения логической функции, поэтому локальные запуски и тесты не завершаются аварийно.
## Проверка перед расходованием
diff --git a/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdx
index bd0f155b29e..e4891992ec4 100644
--- a/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdx
+++ b/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdx
@@ -33,6 +33,7 @@ twenty --version
| `api` | Отправляйте необработанные REST- или GraphQL-запросы |
| `открыть` | Откройте рабочее пространство в браузере |
| `приложение` | Создавайте, собирайте, синхронизируйте, отлаживайте и удаляйте приложения |
+| `локальный` | Сначал, проверить, остановить, обновить и сбросить локальную среду развития |
| `doctor` | Диагностируйте CLI, SDK приложения и подключение к рабочему пространству |
Каждая команда, взаимодействующая с рабочим пространством, принимает `--remote \<name>` для выбора сохранённого подключения вместо подключения по умолчанию и `--json` для структурированного вывода.
@@ -46,7 +47,7 @@ twenty auth login --url https://acme.twenty.com --use
twenty auth status
```
-Используйте адрес рабочего пространства или адрес сервера для локальной установки: `http://localhost:2020` для [локального сервера Docker](/ru/developers/extend/apps/getting-started/local-server), `http://localhost:3000` для исходной копии. Точную команду можно скопировать в разделе **Settings > Developers > CLI**. Для входа через браузер требуется Twenty 2.42 или более поздняя версия.
+Используйте адрес своего рабочего пространства или адрес сервера для локальной установки: `http://localhost:2020` для [локальной среды разработки](/ru/developers/extend/apps/getting-started/local-server), `http://localhost:3000` для исходной версии из репозитория. Точную команду можно скопировать в разделе **Settings > Developers > CLI**. Для входа через браузер требуется Twenty 2.42 или более поздняя версия.
Сохраните несколько подключений, присвоив им имена: