From 54d5b3e53df6fa4cd66c87272218cc30075314cf Mon Sep 17 00:00:00 2001
From: Manuel Cillero <manuel@cillero.es>
Date: Thu, 2 Jul 2026 22:08:28 +0200
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20(seaorm):=20Documenta=20selecci?=
 =?UTF-8?q?=C3=B3n=20del=20motor=20de=20BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Diferencia el patrón para aplicaciones (activan el motor via *feature*
en su `Cargo.toml`) y extensiones (sin *features*; la selección es
responsabilidad de la aplicación).
---
 extensions/pagetop-seaorm/README.md  | 32 ++++++++++++++++++++++------
 extensions/pagetop-seaorm/src/lib.rs | 32 ++++++++++++++++++++++------
 2 files changed, 52 insertions(+), 12 deletions(-)

diff --git a/extensions/pagetop-seaorm/README.md b/extensions/pagetop-seaorm/README.md
index b9b7e1a4..23f130aa 100644
--- a/extensions/pagetop-seaorm/README.md
+++ b/extensions/pagetop-seaorm/README.md
@@ -19,14 +19,34 @@ configurables, basadas en HTML, CSS y JavaScript.
 
 ## Guía rápida
 
-**Añade la dependencia** a tu `Cargo.toml` activando el motor de base de datos que necesites:
+**Añade la dependencia** a tu `Cargo.toml`:
 
-```toml
-[dependencies]
-pagetop-seaorm = { version = "...", features = ["sqlite"] }
-```
+- Si estás desarrollando una **aplicación**, activa el motor de base de datos que necesites:
 
-Las *features* disponibles son `mysql`, `postgres` y `sqlite`.
+  ```toml
+  [features]
+  default  = ["postgres"]
+  mysql    = ["pagetop-seaorm/mysql"]
+  postgres = ["pagetop-seaorm/postgres"]
+  sqlite   = ["pagetop-seaorm/sqlite"]
+
+  [dependencies]
+  pagetop-seaorm = { version = "..." }
+  ```
+
+  Las *features* disponibles son `mysql`, `postgres` y `sqlite`. Gracias a la unificación de
+  *features* de Cargo, activar el motor aquí lo propaga a todos los *crates* del árbol de
+  dependencias que usen `pagetop-seaorm`; no es necesario que cada extensión lo reexporte.
+
+- Si estás escribiendo una **extensión**, declara la dependencia sin *features*:
+
+  ```toml
+  [dependencies]
+  pagetop-seaorm = { version = "..." }
+  ```
+
+  La selección del motor es responsabilidad de la aplicación que use la extensión, no de la
+  extensión misma.
 
 **Configura la conexión** en el archivo de configuración de la aplicación:
 
diff --git a/extensions/pagetop-seaorm/src/lib.rs b/extensions/pagetop-seaorm/src/lib.rs
index 0d47dc1a..9cfcd350 100644
--- a/extensions/pagetop-seaorm/src/lib.rs
+++ b/extensions/pagetop-seaorm/src/lib.rs
@@ -20,14 +20,34 @@ configurables, basadas en HTML, CSS y JavaScript.
 
 ## Guía rápida
 
-**Añade la dependencia** a tu `Cargo.toml` activando el motor de base de datos que necesites:
+**Añade la dependencia** a tu `Cargo.toml`:
 
-```toml
-[dependencies]
-pagetop-seaorm = { version = "...", features = ["sqlite"] }
-```
+- Si estás desarrollando una **aplicación**, activa el motor de base de datos que necesites:
 
-Las *features* disponibles son `mysql`, `postgres` y `sqlite`.
+  ```toml
+  [features]
+  default  = ["postgres"]
+  mysql    = ["pagetop-seaorm/mysql"]
+  postgres = ["pagetop-seaorm/postgres"]
+  sqlite   = ["pagetop-seaorm/sqlite"]
+
+  [dependencies]
+  pagetop-seaorm = { version = "..." }
+  ```
+
+  Las *features* disponibles son `mysql`, `postgres` y `sqlite`. Gracias a la unificación de
+  *features* de Cargo, activar el motor aquí lo propaga a todos los *crates* del árbol de
+  dependencias que usen `pagetop-seaorm`; no es necesario que cada extensión lo reexporte.
+
+- Si estás escribiendo una **extensión**, declara la dependencia sin *features*:
+
+  ```toml
+  [dependencies]
+  pagetop-seaorm = { version = "..." }
+  ```
+
+  La selección del motor es responsabilidad de la aplicación que use la extensión, no de la
+  extensión misma.
 
 **Configura la conexión** en el archivo de configuración de la aplicación: