New Crowdin updates

i18n/es/docusaurus-plugin-content-docs/current/API/QuotaManagerClass.md

@@ -11,12 +11,6 @@ La clase `4D.QuotaManager` le ofrece una interfaz para configurar y monitorizar
 
 :::
 
-:::tip Entradas de blog relacionadas
-
-[Un servidor web 4D que sabe cuándo decir No](https://blog.4d.com/a-4d-web-server-that-knows-when-to-say-no/)
-
-:::
-
 Los objetos `4D.QuotaManager` se pueden instanciar de las siguientes maneras:
 
 - la [propiedad `quotas` de un objeto Session](./SessionClass.md#quotas)

i18n/es/docusaurus-plugin-content-docs/current/Develop/preemptive.md

@@ -41,7 +41,7 @@ Dado que un hilo se maneja de forma independiente a partir del método del proce
 
 La propiedad "seguridad de hilo" de cada elemento depende del elemento en sí:
 
-- Comandos 4D: hilo seguro es una propiedad interna. En la documentación de 4D, los comandos hilo seguro se identifican con el icono ![](../assets/en/Develop/thread-safe.png). También puede utilizar el comando [`Nombre del comando`](../commands/command-name) para saber si un comando es hilo seguro. Gran parte de los comandos 4D pueden ejecutarse en modo apropiativo.
+- Comandos 4D: hilo seguro es una propiedad interna. The 4D documentation indicates whether each command is thread-safe or not in the Properties section.  También puede utilizar el comando [`Nombre del comando`](../commands/command-name) para saber si un comando es hilo seguro. Gran parte de los comandos 4D pueden ejecutarse en modo apropiativo.
 - Métodos de proyecto: las condiciones para seguridad de hilo se listan en [este párrafo](#writing-a-thread-safe-method).
 
 Básicamente, el código que se ejecuta en hilos apropiativos no puede llamar a las partes con las interacciones externas, tal como el código plug-in o las variables interproceso. Los accesos a los datos, sin embargo, son permitidos desde el servidor de datos 4D que soporta la ejecución apropiativa.

i18n/es/docusaurus-plugin-content-docs/current/ORDA/privileges.md

@@ -294,6 +294,12 @@ The project's web security settings are defined in `roles.json`:
 
 :::
 
+:::warning
+
+When a permission entry references an undeclared [privilege](#privileges-and-roles), 4D logs an error and ignores the entry. In this case, the permission is ignored. If the [restricted mode by default](#restriction-modes) is not enabled, the resource is accessible to `guest` sessions.
+
+:::
+
 ### Default location and content
 
 New projects generate `roles.json` at:

i18n/es/docusaurus-plugin-content-docs/current/WebServer/quotas.md

@@ -12,12 +12,6 @@ Las cuotas del servidor web le permiten controlar el uso de recursos limitando e
 
 :::
 
-:::tip Entradas de blog relacionadas
-
-[Un servidor web 4D que sabe cuándo decir No](https://blog.4d.com/a-4d-web-server-that-knows-when-to-say-no/)
-
-:::
-
 ## Requisitos
 
 La configuración de cuotas requiere la activación de las [sesiones escalables](./sessions.md#enabling-web-sessions).

i18n/es/docusaurus-plugin-content-docs/current/embedding-studio/Classes/Definition.md

@@ -0,0 +1,165 @@
+---
+id: definición
+title: Definición
+---
+
+# Definición
+
+The `Definition` class describes how a single vector field on a dataclass should be computed: which dataclass, which vector field, which model alias, and which text template ([Phrase](Phrase.md)) to render from each entity.
+
+A collection of these is what [Settings](Settings.md) persists.
+
+## Propiedades
+
+| Nombre de la propiedad | Tipo                | Descripción                                                                                                                 |
+| ---------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| `dataclassName`        | Text                | Name of the target dataclass.                                                                               |
+| `vectorName`           | Text                | Name of the `4D.Vector` field on that dataclass.                                                            |
+| `modelAlias`           | Text                | Embedding model alias (e.g. `"text-embedding-3-small"`). |
+| `phrase`               | [Phrase](Phrase.md) | Compiled template used to build the text that will be embedded.                                             |
+| `autoInvalidate`       | Boolean             | Controls automatic invalidation on entity save. Default: `True`.            |
+
+## Class constructor
+
+Create a definition.
+
+| Nombre del argumento | Tipo | Descripción                                                                                        |
+| -------------------- | ---- | -------------------------------------------------------------------------------------------------- |
+| *dataclassName*      | Text | Name of the target dataclass.                                                      |
+| *vectorName*         | Text | Name of the target vector field.                                                   |
+| *modelAlias*         | Text | Embedding model alias.                                                             |
+| *phraseTemplate*     | Text | Phrase template with `{field}` placeholders — compiled into a [Phrase](Phrase.md). |
+
+```4d
+var $def:=cs.EmbeddingStudio.Definition.new(\
+	"Students"; \
+	"student_vector_1"; \
+	"text-embedding-3-small"; \
+	"Student {firstName} {lastName}")
+```
+
+## Propiedades calculadas
+
+### hasDefinition
+
+**hasDefinition** : Boolean *(read-only)*
+
+Returns `True` if at least a model or a phrase template has been set. A definition without either has no content to process.
+
+```4d
+If ($def.hasDefinition)
+    // worth validating further
+End if
+```
+
+## Funciones
+
+### validate()
+
+**validate**( *settings* : Settings ) : Object
+
+Validates the definition against the live datastore model and the known embedding models. All errors are collected before returning — the result always describes the full set of problems found.
+
+| Argumento  | Tipo                            | Descripción                                                                                                  |
+| ---------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| *settings* | [Settings](Settings.md) \| Null | Used to pass phrase validation options. Pass `Null` to skip phrase options.  |
+| Resultado  | Object                          | `{success: Boolean, errors: Collection}` where each error is `{field: Text, message: Text}`. |
+
+Checked in order:
+
+| Check                                | `field` value     |
+| ------------------------------------ | ----------------- |
+| `dataclassName` is not empty         | `"dataclassName"` |
+| `vectorName` is not empty            | `"vectorName"`    |
+| `modelAlias` is set and recognised   | `"modelAlias"`    |
+| Dataclass exists in `ds`             | `"dataclassName"` |
+| Vector field exists                  | `"vectorName"`    |
+| Field type is `4D.Vector`            | `"vectorName"`    |
+| Phrase template is not empty         | `"phrase"`        |
+| Phrase keys resolve in the dataclass | `"phrase"`        |
+
+The first two checks (identity) return immediately on failure; the remaining checks accumulate so all problems are reported in one pass.
+
+```4d
+var $result:=$def.validate(cs.EmbeddingStudio.Settings.new())
+
+If (Not($result.success))
+    var $err : Object
+    For each ($err; $result.errors)
+        TRACE  // $err.field, $err.message
+    End for each
+End if
+```
+
+### invalidateVectors()
+
+**invalidateVectors**() : Object
+
+Marks all already-computed entities for re-embedding, forcing a full rebuild on the next run. Only entities that already have a vector value are processed — entities with a `Null` vector are skipped.
+
+Useful during development or after a model/phrase change to trigger a clean rebuild of all vectors.
+
+The strategy depends on whether a companion `_dirty` field exists on the dataclass:
+
+| Companion `_dirty` field | Action taken                                                   |
+| ------------------------ | -------------------------------------------------------------- |
+| Present                  | Sets `<vectorName>_dirty` to `True` — vector is left untouched |
+| Absent                   | Nullifies the vector field                                     |
+
+| Argumento | Tipo   | Descripción                                                        |
+| --------- | ------ | ------------------------------------------------------------------ |
+| Resultado | Object | `{updated: Integer, skipped: Integer, errors: Collection of Text}` |
+
+- `updated` — number of entities successfully marked
+- `skipped` — number of entities that could not be saved
+- `errors` — one entry per save failure, formatted as `"DataclassName: statusText"`
+
+```4d
+var $result:=$def.invalidateVectors()
+
+If ($result.skipped > 0)
+    var $e : Text
+    For each ($e; $result.errors)
+       // $e
+    End for each
+End if
+// → { updated: 42; skipped: 0; errors: [] }
+```
+
+### toObject()
+
+**toObject**() : Object
+
+Returns a plain object suitable for JSON persistence. The phrase is flattened to its template text.
+
+| Argumento | Tipo   | Descripción                                                                                                                       |
+| --------- | ------ | --------------------------------------------------------------------------------------------------------------------------------- |
+| Resultado | Object | `{version, dataclassName, vectorName, modelAlias, phrase, autoInvalidate}` where `phrase` is the template string. |
+
+```4d
+$def.toObject()
+// → { version: 0; dataclassName: "Students"; vectorName: "student_vector_1";
+//     modelAlias: "text-embedding-3-small"; phrase: "Student {firstName} {lastName}";
+//     autoInvalidate: true }
+```
+
+## Automatic invalidation
+
+`autoInvalidate` controls whether save-time automatic invalidation is enabled for this definition.
+
+- `True` (default): when relevant attributes change on an entity save, vectors are automatically invalidated.
+- `False`: save-time automatic invalidation is skipped for this definition.
+
+This setting does not affect manual invalidation via `invalidateVectors()`.
+
+## Dirty flag convention
+
+The pipeline in [Process](Process.md) will recompute an entity whenever the target vector is `Null`, or when a sibling field `<vectorName>_dirty` exists on the dataclass and is `True`.
+
+Declaring the dirty flag is optional — when absent, only the null-vector case triggers recomputation. When present, it is cleared automatically on successful save.
+
+## Ver también
+
+- [Settings](Settings.md)
+- [Process](Process.md)
+- [Phrase](Phrase.md)

i18n/es/docusaurus-plugin-content-docs/current/embedding-studio/Classes/Embedder.md

@@ -0,0 +1,96 @@
+---
+id: embedder
+title: Embedder
+---
+
+# Embedder
+
+The `Embedder` class is a thin wrapper around [4D AIKit](https://developer.4d.com/docs/aikit/Classes/openai) focused on embeddings. It exposes two functions — one for a single text, one for a batch — and handles retries with exponential backoff (respecting the `Retry-After` header when present).
+
+It is stateless beyond configuration and safe to share between processes.
+
+## Propiedades
+
+| Nombre de la propiedad | Tipo                                            | Descripción                                                                                                  |
+| ---------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| `client`               | cs.AIKit.OpenAI | The underlying AIKit client used for HTTP requests.                                          |
+| `maxRetries`           | Integer                                         | Maximum number of retries on transient errors. Default: `3`. |
+| `backoffMs`            | Integer                                         | Base delay (ms) between retries. Doubled each attempt.    |
+
+## Class constructor
+
+Create a embedder. All options are optional.
+
+| Nombre del argumento | Tipo   | Descripción                                                                   |
+| -------------------- | ------ | ----------------------------------------------------------------------------- |
+| *opciones*           | Object | `{client, maxRetries, backoffMs}` — any field may be omitted. |
+
+```4d
+// Default — uses cs.AIKit.OpenAI.new() internally
+var $proc:=cs.EmbeddingStudio.Embedder.new()
+
+// Provide a pre-configured AIKit client (custom API key, base URL, etc.)
+var $client:=cs.AIKit.OpenAI.new({apiKey: "…"; baseURL: "https://server.ai"})
+var $proc:=cs.EmbeddingStudio.Embedder.new({client: $client; maxRetries: 5; backoffMs: 1000})
+```
+
+> If the 4D AIKit component is not loaded (or is too old to provide `OpenAIProviders`), the constructor still succeeds with a `Null` client, and the first `embed()` / `embedBatch()` call throws an error whose `message` explains what is missing and whose `isAIKitMissing` property is `True`.
+
+## Funciones
+
+### embed()
+
+**embed**(*text* : Text ; *model* : Text) : [cs.EmbeddingStudio.EmbedderResult](EmbedderResult.md)
+
+Embed a single text. Returns a typed result with the embedding vector, token usage, and rate-limit state.
+
+| Argumento | Tipo                                                                                   | Descripción                                                                                                                                       |
+| --------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| *text*    | Text                                                                                   | The text to vectorize.                                                                                                            |
+| *model*   | Text                                                                                   | The embedding model to use (e.g. `"text-embedding-3-small"`).                  |
+| Resultado | [cs.EmbeddingStudio.EmbedderResult](EmbedderResult.md) | Typed wrapper — `.vector` holds the embedding, `.promptTokens` / `.totalTokens` hold usage, rate-limit fields are flat camelCase. |
+
+Throws if retries are exhausted or the API returns a non-retryable error.
+
+```4d
+var $result:=$proc.embed("it rains cats and dogs"; "text-embedding-3-small")
+// $result.vector          → 4D.Vector
+// $result.promptTokens    → Integer
+// $result.totalTokens     → Integer
+// $result.remainingTokens → Integer (-1 if unknown)
+```
+
+### embedBatch()
+
+**embedBatch**(*texts* : Collection ; *model* : Text) : [cs.EmbedderResult](EmbedderResult.md)
+
+Embed a collection of texts in a single API call. Returns a typed result with vectors in the same order as inputs, token usage, and rate-limit state.
+
+| Argumento | Tipo                                                   | Descripción                                                                                                                 |
+| --------- | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
+| *texts*   | Collection                                             | Collection of Text to vectorize. Empty or `Null` returns an empty result.                   |
+| *model*   | Text                                                   | The embedding model to use.                                                                                 |
+| Resultado | [cs.EmbedderResult](EmbedderResult.md) | Typed wrapper — `.vectors` holds the embeddings collection, token and rate-limit fields are flat camelCase. |
+
+```4d
+var $result:=$proc.embedBatch(["hello"; "world"]; "text-embedding-3-small")
+// $result.vectors[0]      → 4D.Vector for "hello"
+// $result.vectors[1]      → 4D.Vector for "world"
+// $result.totalTokens     → Integer (sum for the batch)
+// $result.remainingTokens → Integer (after this call)
+```
+
+## Retry policy
+
+Transient errors (HTTP 408, 409, 429, 5xx) are retried up to `maxRetries` times.
+
+- If the response carries a `Retry-After` or `retry-after-ms` header, the embedder waits that long.
+- Otherwise, it waits `backoffMs * 2^attempt`.
+
+Non-retryable errors are thrown immediately — see [OpenAIError](https://developer.4d.com/docs/aikit/Classes/openaierror) for the thrown shape.
+
+## Ver también
+
+- [EmbedderResult](EmbedderResult.md)
+- [Process](Process.md)
+- [OpenAIEmbeddingsAPI](https://developer.4d.com/docs/aikit/Classes/openaiembeddingsapi) (AIKit)