From 4ac92ab405c10654d6b6a2dd7bcae1cc55dfd676 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CSebastian?= <64795732+slegarraga@users.noreply.github.com> Date: Thu, 6 Aug 2026 01:41:31 -0400 Subject: [PATCH] Add faithful Spanish translation for organization profile --- profile/README.es.md | 235 ++++++++++++++++++++----------------------- profile/README.md | 2 + 2 files changed, 111 insertions(+), 126 deletions(-) diff --git a/profile/README.es.md b/profile/README.es.md index 28e781c..e4d4e63 100644 --- a/profile/README.es.md +++ b/profile/README.es.md @@ -1,172 +1,155 @@ -# BeyondNet Code +
+ BeyondNet Tech -> Read this in [English](README.md) +

Arquitectura empresarial, en abierto.
+ Corpus de referencia, estándares de gobernanza y librerías .NET/TypeScript que puedes leer, hacer fork y distribuir.

-> Open Source. Arquitectura Moderna. Innovación sin límites. + Repositorios + Discusiones + PRs bienvenidos + Buenos primeros issues +
---- +> 🌐 [English](README.md) -## Sobre Nosotros +--- -**BeyondNet Code** es una organización tecnológica abierta dedicada a la creación colaborativa de código, documentación arquitectónica, referencias de ingeniería y activos de desarrollo de software bajo licencias abiertas. +## Qué construimos realmente -Nuestro objetivo es ayudar a la comunidad técnica a diseñar, documentar y evolucionar sistemas de software modernos con criterio arquitectónico profesional. +No es un manifiesto: tres cosas concretas. -Trabajamos especialmente en: +1. **Un corpus de arquitectura progresiva** (`Evolith / Arc32`): ADRs, patrones canónicos y reglas de gobernanza que llevan un sistema de monólito modular a microservicios *sin reescribirlo*. Documentado, versionado y aplicado por CI. +2. **Herramientas SDLC que aplican el corpus** (`Evolith Tracker`): requisitos → código → quality gates → deploy, con trazabilidad auditable. +3. **Librerías .NET y TypeScript reutilizables** (`Shell.*`, `UMS`): AOP, bootstrap de DI, fábricas, bloques de construcción DDD e identidad. Pequeñas, enfocadas y con licencias permisivas. -- Arquitectura de software moderna -- Monolitos modulares y microservicios sostenibles -- Clean Architecture y Hexagonal Architecture -- DDD pragmático -- DevOps, observabilidad y automatización -- Ingeniería asistida por IA -- Documentación técnica abierta +Todo está aumentado por agentes por diseño: las instrucciones (`AGENTS.md`) viven *dentro* de los repositorios, de modo que un agente de código hereda los mismos estándares que una persona colaboradora. --- -## Proyectos Destacados - -| Proyecto | Descripción | Enlace | -|---|---|---| -| **Evolith** | Plataforma de arquitectura progresiva empresarial — la referencia autoritativa para evolucionar productos desde Monolitos Modulares a sistemas distribuidos, gobernada y asistida por IA por diseño. | https://github.com/beyondnetcode/evolith_arch32 | -| **UMS** | Sistema de referencia para gestión de usuarios, identidad, autorización y gobierno multi-tenant. | https://github.com/beyondnetcode/ums | +## Empieza aquí: elige tu camino + + + + + + + +
+

Úsalo

+

15 paquetes en NuGet. A un comando de distancia.

+ + 		+

Apréndelo

+

Lee el razonamiento antes que el código.

+ + 		+

Constrúyelo

+

Envía tu primer PR esta semana.

+ +
--- -## Visión Arquitectónica - -Creemos que los productos modernos deben poder empezar simples, crecer con orden y evolucionar sin reescrituras traumáticas. - -Nuestra idea central: - -> Separar conceptualmente antes de separar físicamente. +## Instalación -No todo producto necesita microservicios desde el día uno. +```bash +dotnet add package BeyondNetCode.Shell.Aop # AOP via DispatchProxy +dotnet add package BeyondNetCode.Shell.Ddd # bloques de construcción DDD +dotnet add package BeyondNetCode.Shell.Factory # fábricas guiadas por configuración +``` -Pero todo producto serio necesita límites claros, decisiones explícitas, contratos técnicos, observabilidad y una ruta de evolución. +Compatible con `net10.0`. La familia completa — aspectos, integración con Serilog, instaladores de DI, value objects, perfiles de AutoMapper, observabilidad — está en [nuget.org/profiles/beyondnet](https://www.nuget.org/profiles/beyondnet). --- -## Licencias +## Proyectos -Nuestros proyectos priorizan licencias abiertas y colaboración comunitaria. +| Proyecto | Qué es | Stack | Estado | +|---|---|---|---| +| **[Evolith / Arc32](https://github.com/beyondnetcode/evolith_arch32)** | Corpus de referencia de arquitectura progresiva: estándares, ADRs y reglas de gobernanza que heredan los productos satélite. | TypeScript · docs | Activo · MIT | +| **[Evolith Tracker](https://github.com/beyondnetcode/evolith_tracker)** | Seguimiento SDLC de extremo a extremo: ideación → quality gates → deploy, totalmente trazable. | C# / .NET | Beta | +| **[Why-Architecture](https://github.com/beyondnetcode/why-architecture)** | El *porqué* detrás de cada patrón que publicamos. Documentos y artefactos de ejemplo. | Docs · CC0 | Activo | +| **[UMS](https://github.com/beyondnetcode/ums)** | Sistema de gestión de usuarios: identidades, autenticación y autorización. | C# / .NET | Prototipo | +| **[Shell.*](https://github.com/orgs/beyondnetcode/repositories?q=Shell)** | `Shell.Aop` · `Shell.Bootstrapper` · `Shell.Factory` · `Shell.DDD` — bloques de construcción .NET enfocados. | C# / .NET | Activo | -| Licencia | Uso | -|---|---| -| **MIT** | Código fuente abierto y reutilizable | -| **Creative Commons** | Documentación, guías y contenido técnico | -| **Open Source** | Transparencia, colaboración y aprendizaje compartido | +
+ + Visión de producto Evolith de extremo a extremo + +
Visión de producto Evolith de extremo a extremo · haz clic para ampliar +
--- -## Áreas Técnicas - -### Backend - -- .NET / ASP.NET Core -- Node.js / NestJS -- TypeScript -- Arquitectura Hexagonal -- Clean Architecture -- DDD pragmático +## Buenos primeros issues -### Frontend +Mantenemos una lista curada de entradas. Cada issue etiquetado como `good first issue` indica su alcance, los archivos exactos a tocar y los criterios de aceptación que tu PR debe cumplir, sin necesidad de adivinar. -- React -- Next.js -- Vue.js -- Vite -- Design Systems +
+ Explorar buenos primeros issues + Explorar ayuda solicitada +
-### DevOps y Plataforma +**Qué necesitamos ahora mismo:** -- Docker -- Kubernetes -- GitHub Actions -- Observabilidad -- CI/CD -- Infraestructura como código +- **Ingenieros .NET** — ampliar la cobertura de pruebas de `Shell.*`, publicar la siguiente versión de las librerías y endurecer los flujos de token de `UMS`. +- **Ingenieros TypeScript / Node** — implementaciones de referencia de los patrones Arc32 en NestJS. +- **Ingenieros de agentes** — mejorar los conjuntos de instrucciones de `AGENTS.md` y construir harnesses de evaluación para PRs generados por agentes. +- **DevOps** — plantillas de CI, imágenes de contenedores y automatización de releases en toda la organización. +- **Escritores técnicos** — paridad inglés/español en `Why-Architecture` y en el corpus de ADRs. -### AI Engineering - -- OpenAI -- Semantic Kernel -- LangChain -- MCP -- AI-assisted SDLC -- Agentic Engineering +¿No encuentras un issue que encaje? [Abre uno](https://github.com/beyondnetcode/evolith_arch32/issues/new/choose) o [inicia una discusión](https://github.com/orgs/beyondnetcode/discussions); las propuestas son bienvenidas antes que el código. --- -## Cómo Contribuir - -Puedes colaborar de varias formas: - -1. Revisando documentación técnica. -2. Proponiendo mejoras arquitectónicas. -3. Abriendo issues con gaps o inconsistencias. -4. Enviando Pull Requests. -5. Mejorando ejemplos de código. -6. Agregando pruebas o fitness functions. -7. Ayudando con traducciones en inglés y español. +## Tu primera contribución, en 4 pasos -Repositorios principales: +```bash +# 1. Fork y clone +gh repo fork beyondnetcode/evolith_arch32 --clone -- Evolith: https://github.com/beyondnetcode/evolith_arch32 -- UMS: https://github.com/beyondnetcode/ums +# 2. Rama (commitlint exige nomenclatura convencional) +git checkout -b feat/your-change ---- +# 3. Commit — Conventional Commits, validado por husky +git commit -m "feat(reference): add ADR for outbox pattern" -## Enlaces Útiles +# 4. Push y abre el PR +gh pr create --fill +``` -| Recurso | Enlace | -|---|---| -| Organización GitHub | https://github.com/beyondnetcode | -| Evolith | https://github.com/beyondnetcode/evolith_arch32 | -| UMS | https://github.com/beyondnetcode/ums | -| Perfil del fundador | https://github.com/beyondnetPeru | -| C# Sandbox Code | https://github.com/csdevlib | -| Discussions | Próximamente | +Lee [CONTRIBUTING.md](https://github.com/beyondnetcode/evolith_arch32/blob/main/CONTRIBUTING.md) ([ES](https://github.com/beyondnetcode/evolith_arch32/blob/main/CONTRIBUTING.es.md)) una vez; cubre las puertas de gobernanza, el proceso de ADRs y cómo proponer un cambio a un estándar. --- -## Fundador - -**Alberto Arroyo Raygada** -Principal Software Architect - -Experiencia en: - -- Arquitectura empresarial -- Modernización de sistemas -- Monolitos modulares -- Microservicios -- DDD y Clean Architecture -- DevOps y Cloud -- Ingeniería asistida por IA - -Contacto: +## Cómo decidimos -- GitHub: https://github.com/beyondnetPeru -- Email: beyondnet.peru@gmail.com +Los cambios de arquitectura pasan por **ADRs**, no por opiniones. Cualquier persona puede proponer uno; los mantenedores lo revisan contra el corpus en [`reference/`](https://github.com/beyondnetcode/evolith_arch32/tree/main/reference). El desacuerdo es esperado y queda documentado: ese es el punto de escribir las decisiones. ---- - -## Estado de la Comunidad - -```text -Foco técnico: Arquitectura moderna y open source -Proyectos: Referencias técnicas y laboratorios de arquitectura -Alcance: Comunidad global en español e inglés -Licencia: Open Source / MIT -``` +- [Guía de contribución](https://github.com/beyondnetcode/evolith_arch32/blob/main/CONTRIBUTING.md) ([ES](https://github.com/beyondnetcode/evolith_arch32/blob/main/CONTRIBUTING.es.md)) +- [Política de seguridad](https://github.com/beyondnetcode/evolith_arch32/blob/main/SECURITY.md) +- Licencias: MIT y Apache-2.0 para librerías, CC0 para corpus de documentación. --- -## Invitación - -BeyondNet Code está abierto a profesionales, arquitectos, tech leads, backend engineers, platform engineers, DevOps, QA engineers, security engineers y technical writers que quieran colaborar en referencias técnicas abiertas. - -La arquitectura de software mejora cuando se discute, se documenta, se prueba y se valida en comunidad. +
+ + Contribuidores + -Bienvenido a BeyondNet Code. +

"El código va más allá de la sintaxis; es la arquitectura del futuro. Únete a nosotros para construirlo."

+

Mantenido por Alberto Arroyo Raygada y contribuidores · + Discusiones

+
diff --git a/profile/README.md b/profile/README.md index e97a8bf..b3fa035 100644 --- a/profile/README.md +++ b/profile/README.md @@ -10,6 +10,8 @@ Good first issues +> 🌐 [Español](README.es.md) + --- ## What we actually build