Loading documentation...
Preparing Ring content
Conceptos, valor y escenarios típicos de clon — menos código.
Conceptos, valor y escenarios típicos de clon — menos código.
Preparing Ring content
Preparing Ring content
Preparing Ring content
Usa las pestañas Fundador / Desarrollador de la barra lateral de la documentación para filtrar esta página. En resumen: toda la aplicación es de código abierto. Lo que sigue siendo privado es el alojamiento de Ringdom, el pipeline de CI y un pequeño conjunto de módulos solo para operadores.
Ring se construye por capas. Layer 1 es la base de código de la comunidad, publicada en GitHub como connectplatform/ring con licencia Apache 2.0. Los paquetes de Layer 2 (ring-presets/<pack>) añaden presets verticales. Los overlays de Layer 3 (ringdom-clones/<slug>) contienen la marca, la documentación y los módulos privados de un clon. Una build copia primero Layer 1 y después coloca los overlays encima. Cuando el mismo archivo existe en más de una capa, gana la capa posterior.
| Capacidad | OSS público (GitHub) | Colono de Ringdom |
|---|---|---|
Aplicación Next.js completa (web/): tienda, monedero, noticias, mensajería, administración y el resto | Sí | Sí |
install.sh, utilidades de ring/scripts/, data/schema.sql | Sí | Sí |
ring CLI (cli/) | Sí. upgrade, config y test funcionan en cualquier sitio | Sí, más la ruta de build privada |
| Archivos Docker y plantillas de env | Sí | Sí |
| Documentación base | Mínima (web/docs/en/index.mdx más dos páginas de funcionalidades) | Corpus completo del portal en el overlay |
Manifiestos de Kubernetes (k8s/) | No | Sí |
Workflows de CI de Forgejo (.forgejo/) y pipeline de build de la forja | No. Se eliminan del espejo de GitHub | Sí |
Order Lab, calculadoras, my-orders, my-jobs, pedidos del CRM de administración | No. Solo stubs de la comunidad | Sí |
Selección de preset en ring-config.json y catálogos de Layer 1 (features/entities/presets/) | Sí | Sí |
Paquetes de presets de Layer 2 (ring-presets/<pack>) | No. Alojados en la forja | Sí |
Clona el repositorio público, ejecuta el asistente y alójalo donde quieras. El código, los datos y los miembros son tuyos.
Los presets dan a un clon una forma predefinida para un sector. Layer 1 incluye el selector. Los paquetes más completos se distribuyen a través de Ringdom.
La guía de ringización cubre el camino del colono: un overlay ligero sobre Layer 1, compilado y alojado por Ringdom.
Las filas marcadas con No en la tabla. Order Lab, los pedidos de proyectos y las calculadoras compilan contra stubs de la comunidad, así que la build sigue funcionando. Cada clon de colono puede además incluir sus propios módulos privados en su overlay.
Sí para upgrade, config y test. prod necesita tus propios manifiestos de Kubernetes y tu registro. Consulta Ring CLI.
El corpus completo de documentación de ring-platform.org vive en el overlay privado de Layer 3 y se sirve públicamente en /docs. Layer 1 mantiene una pequeña base para la comunidad en web/docs/.
Siguiente paso: las herramientas públicas de configuración y mantenimiento en detalle.
Mismo flujo: ejecutar la build OSS en tu propio servidor.
Ver también: el camino del colono, de un overlay ligero a un clon alojado.
En profundidad: qué comandos de la CLI funcionan fuera de Ringdom.
Usa las pestañas Fundador / Desarrollador de la barra lateral de la documentación para filtrar esta página. En resumen: toda la aplicación es de código abierto. Lo que sigue siendo privado es el alojamiento de Ringdom, el pipeline de CI y un pequeño conjunto de módulos solo para operadores.
Ring se construye por capas. Layer 1 es la base de código de la comunidad, publicada en GitHub como connectplatform/ring con licencia Apache 2.0. Los paquetes de Layer 2 (ring-presets/<pack>) añaden presets verticales. Los overlays de Layer 3 (ringdom-clones/<slug>) contienen la marca, la documentación y los módulos privados de un clon. Una build copia primero Layer 1 y después coloca los overlays encima. Cuando el mismo archivo existe en más de una capa, gana la capa posterior.
| Capacidad | OSS público (GitHub) | Colono de Ringdom |
|---|---|---|
Aplicación Next.js completa (web/): tienda, monedero, noticias, mensajería, administración y el resto | Sí | Sí |
install.sh, utilidades de ring/scripts/, data/schema.sql | Sí | Sí |
ring CLI (cli/) | Sí. upgrade, config y test funcionan en cualquier sitio | Sí, más la ruta de build privada |
| Archivos Docker y plantillas de env | Sí | Sí |
| Documentación base | Mínima (web/docs/en/index.mdx más dos páginas de funcionalidades) | Corpus completo del portal en el overlay |
Manifiestos de Kubernetes (k8s/) | No | Sí |
Workflows de CI de Forgejo (.forgejo/) y pipeline de build de la forja | No. Se eliminan del espejo de GitHub | Sí |
Order Lab, calculadoras, my-orders, my-jobs, pedidos del CRM de administración | No. Solo stubs de la comunidad | Sí |
Selección de preset en ring-config.json y catálogos de Layer 1 (features/entities/presets/) | Sí | Sí |
Paquetes de presets de Layer 2 (ring-presets/<pack>) | No. Alojados en la forja | Sí |
Clona el repositorio público, ejecuta el asistente y alójalo donde quieras. El código, los datos y los miembros son tuyos.
Los presets dan a un clon una forma predefinida para un sector. Layer 1 incluye el selector. Los paquetes más completos se distribuyen a través de Ringdom.
La guía de ringización cubre el camino del colono: un overlay ligero sobre Layer 1, compilado y alojado por Ringdom.
Las filas marcadas con No en la tabla. Order Lab, los pedidos de proyectos y las calculadoras compilan contra stubs de la comunidad, así que la build sigue funcionando. Cada clon de colono puede además incluir sus propios módulos privados en su overlay.
Sí para upgrade, config y test. prod necesita tus propios manifiestos de Kubernetes y tu registro. Consulta Ring CLI.
El corpus completo de documentación de ring-platform.org vive en el overlay privado de Layer 3 y se sirve públicamente en /docs. Layer 1 mantiene una pequeña base para la comunidad en web/docs/.
Siguiente paso: las herramientas públicas de configuración y mantenimiento en detalle.
Mismo flujo: ejecutar la build OSS en tu propio servidor.
Ver también: el camino del colono, de un overlay ligero a un clon alojado.
En profundidad: qué comandos de la CLI funcionan fuera de Ringdom.
Usa las pestañas Fundador / Desarrollador de la barra lateral de la documentación para filtrar esta página. En resumen: toda la aplicación es de código abierto. Lo que sigue siendo privado es el alojamiento de Ringdom, el pipeline de CI y un pequeño conjunto de módulos solo para operadores.
Ring se construye por capas. Layer 1 es la base de código de la comunidad, publicada en GitHub como connectplatform/ring con licencia Apache 2.0. Los paquetes de Layer 2 (ring-presets/<pack>) añaden presets verticales. Los overlays de Layer 3 (ringdom-clones/<slug>) contienen la marca, la documentación y los módulos privados de un clon. Una build copia primero Layer 1 y después coloca los overlays encima. Cuando el mismo archivo existe en más de una capa, gana la capa posterior.
| Capacidad | OSS público (GitHub) | Colono de Ringdom |
|---|---|---|
Aplicación Next.js completa (web/): tienda, monedero, noticias, mensajería, administración y el resto | Sí | Sí |
install.sh, utilidades de ring/scripts/, data/schema.sql | Sí | Sí |
ring CLI (cli/) | Sí. upgrade, config y test funcionan en cualquier sitio | Sí, más la ruta de build privada |
| Archivos Docker y plantillas de env | Sí | Sí |
| Documentación base | Mínima (web/docs/en/index.mdx más dos páginas de funcionalidades) | Corpus completo del portal en el overlay |
Manifiestos de Kubernetes (k8s/) | No | Sí |
Workflows de CI de Forgejo (.forgejo/) y pipeline de build de la forja | No. Se eliminan del espejo de GitHub | Sí |
Order Lab, calculadoras, my-orders, my-jobs, pedidos del CRM de administración | No. Solo stubs de la comunidad | Sí |
Selección de preset en ring-config.json y catálogos de Layer 1 (features/entities/presets/) | Sí | Sí |
Paquetes de presets de Layer 2 (ring-presets/<pack>) | No. Alojados en la forja | Sí |
Clona el repositorio público, ejecuta el asistente y alójalo donde quieras. El código, los datos y los miembros son tuyos.
Los presets dan a un clon una forma predefinida para un sector. Layer 1 incluye el selector. Los paquetes más completos se distribuyen a través de Ringdom.
La guía de ringización cubre el camino del colono: un overlay ligero sobre Layer 1, compilado y alojado por Ringdom.
Las filas marcadas con No en la tabla. Order Lab, los pedidos de proyectos y las calculadoras compilan contra stubs de la comunidad, así que la build sigue funcionando. Cada clon de colono puede además incluir sus propios módulos privados en su overlay.
Sí para upgrade, config y test. prod necesita tus propios manifiestos de Kubernetes y tu registro. Consulta Ring CLI.
El corpus completo de documentación de ring-platform.org vive en el overlay privado de Layer 3 y se sirve públicamente en /docs. Layer 1 mantiene una pequeña base para la comunidad en web/docs/.
Siguiente paso: las herramientas públicas de configuración y mantenimiento en detalle.
Mismo flujo: ejecutar la build OSS en tu propio servidor.
Ver también: el camino del colono, de un overlay ligero a un clon alojado.
En profundidad: qué comandos de la CLI funcionan fuera de Ringdom.
web/LICENSE.| Espejo de GitHub | scripts/push-github-oss.sh | Genera un único commit desde la punta de la forja sin .forgejo/ y lo envía a github/main |
| Control de fugas | scripts/check-no-org-leak.sh (npm run check:org-leak) | Falla si k8s, cli (dentro de web/), .forgejo, .env.local, Order Lab, la calculadora o las rutas my-orders / my-jobs son rutas reales en ring/web en lugar de estar ausentes o ser enlaces simbólicos. También exige que ring-config.json sea un archivo normal versionado |
| Stubs de la comunidad | scripts/ensure-community-stubs.sh | Restaura las versiones de la comunidad, como lib/payments/conductor/handlers/project-order.community.ts, cuando faltan los enlaces del overlay |
| Reglas de ignorado | web/.gitignore | Mantiene web/k8s/, web/cli/, web/scripts/, web/propagation/ y .forgejo/ fuera de los commits de Layer 1 |
| Informe de sombreado | npm run compose:shadow | Lista las rutas de Layer 1 que sustituye un overlay, para que las sobrescrituras se vean en la revisión |
Los cli/ y scripts/ de la raíz del repositorio son públicos. Solo se ignoran las rutas web/cli, web/k8s y web/scripts, porque en las máquinas de Ringdom son enlaces simbólicos locales al overlay privado.
Trabaja solo sobre Layer 1
Haz los cambios para la comunidad en ring/web o ring/cli. Nunca hagas commit de archivos ni enlaces simbólicos del overlay.
Ejecuta los controles
Mantén fuera los secretos
Las plantillas de env solo contienen marcadores. Nunca pongas claves reales en comentarios de código, ejemplos MDX ni en ring-config.json.
web/LICENSE.| Espejo de GitHub | scripts/push-github-oss.sh | Genera un único commit desde la punta de la forja sin .forgejo/ y lo envía a github/main |
| Control de fugas | scripts/check-no-org-leak.sh (npm run check:org-leak) | Falla si k8s, cli (dentro de web/), .forgejo, .env.local, Order Lab, la calculadora o las rutas my-orders / my-jobs son rutas reales en ring/web en lugar de estar ausentes o ser enlaces simbólicos. También exige que ring-config.json sea un archivo normal versionado |
| Stubs de la comunidad | scripts/ensure-community-stubs.sh | Restaura las versiones de la comunidad, como lib/payments/conductor/handlers/project-order.community.ts, cuando faltan los enlaces del overlay |
| Reglas de ignorado | web/.gitignore | Mantiene web/k8s/, web/cli/, web/scripts/, web/propagation/ y .forgejo/ fuera de los commits de Layer 1 |
| Informe de sombreado | npm run compose:shadow | Lista las rutas de Layer 1 que sustituye un overlay, para que las sobrescrituras se vean en la revisión |
Los cli/ y scripts/ de la raíz del repositorio son públicos. Solo se ignoran las rutas web/cli, web/k8s y web/scripts, porque en las máquinas de Ringdom son enlaces simbólicos locales al overlay privado.
Trabaja solo sobre Layer 1
Haz los cambios para la comunidad en ring/web o ring/cli. Nunca hagas commit de archivos ni enlaces simbólicos del overlay.
Ejecuta los controles
Mantén fuera los secretos
Las plantillas de env solo contienen marcadores. Nunca pongas claves reales en comentarios de código, ejemplos MDX ni en ring-config.json.
web/LICENSE.| Espejo de GitHub | scripts/push-github-oss.sh | Genera un único commit desde la punta de la forja sin .forgejo/ y lo envía a github/main |
| Control de fugas | scripts/check-no-org-leak.sh (npm run check:org-leak) | Falla si k8s, cli (dentro de web/), .forgejo, .env.local, Order Lab, la calculadora o las rutas my-orders / my-jobs son rutas reales en ring/web en lugar de estar ausentes o ser enlaces simbólicos. También exige que ring-config.json sea un archivo normal versionado |
| Stubs de la comunidad | scripts/ensure-community-stubs.sh | Restaura las versiones de la comunidad, como lib/payments/conductor/handlers/project-order.community.ts, cuando faltan los enlaces del overlay |
| Reglas de ignorado | web/.gitignore | Mantiene web/k8s/, web/cli/, web/scripts/, web/propagation/ y .forgejo/ fuera de los commits de Layer 1 |
| Informe de sombreado | npm run compose:shadow | Lista las rutas de Layer 1 que sustituye un overlay, para que las sobrescrituras se vean en la revisión |
Los cli/ y scripts/ de la raíz del repositorio son públicos. Solo se ignoran las rutas web/cli, web/k8s y web/scripts, porque en las máquinas de Ringdom son enlaces simbólicos locales al overlay privado.
Trabaja solo sobre Layer 1
Haz los cambios para la comunidad en ring/web o ring/cli. Nunca hagas commit de archivos ni enlaces simbólicos del overlay.
Ejecuta los controles
Mantén fuera los secretos
Las plantillas de env solo contienen marcadores. Nunca pongas claves reales en comentarios de código, ejemplos MDX ni en ring-config.json.