Skip to content

README.es.md

Latest commit

 

History

History
154 lines (114 loc) · 9.5 KB

README.es.md

File metadata and controls

154 lines (114 loc) · 9.5 KB
Raw
BeyondNet Tech

Arquitectura empresarial, en abierto.
Un framework de gobernanza ejecutable, y los bloques .NET que implementan lo que ese framework exige.

Repositorios Discussions PRs bienvenidos Good first issues

Read this in English

Qué construimos realmente

No es un manifiesto — dos cosas concretas:

  1. Gobernanza arquitectónica ejecutable (Evolith / Arc32): ADRs, patrones canónicos y reglas de gobernanza que llevan un sistema del monolito modular a los microservicios sin reescribirlo. Aquí la gobernanza no es un documento: es una capacidad operativa expuesta mediante una CLI, un servidor MCP y una API REST, de modo que las reglas se validan automáticamente en lugar de revisarse a mano.
  2. Librerías .NET reutilizables (Shell.*): AOP, orquestación del arranque, factorías y bloques de DDD. Pequeñas, enfocadas, con licencias permisivas y publicadas en NuGet.

Todo está aumentado con IA por diseño: las instrucciones para agentes (AGENTS.md) viajan dentro de los repositorios, así un agente de código hereda los mismos estándares que una persona que contribuye.

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

Publica tu primer PR esta semana.

Instalación

dotnet add package BeyondNetCode.Shell.Aop      # AOP mediante DispatchProxy
dotnet add package BeyondNetCode.Shell.Ddd      # bloques de DDD
dotnet add package BeyondNetCode.Shell.Factory  # factorías dirigidas por configuración

Compilan contra net10.0. La familia completa — aspectos, integración con Serilog, instaladores de DI, objetos de valor, perfiles de AutoMapper, observabilidad — está en nuget.org/profiles/beyondnet.

Proyectos

Proyecto Qué es Stack Estado
Evolith / Arc32 Gobernanza arquitectónica ejecutable: estándares, ADRs y compuertas de fase, entregados como CLI, servidor MCP y API REST. TypeScript · docs Activo · MIT
Shell.Ddd Bloques de DDD: entidades, raíces de agregado, objetos de valor, eventos de dominio, reglas de negocio. C# / .NET Activo · MIT
Shell.Bootstrapper Orquestación del arranque con el patrón Composite: cada paso independiente, testeable y asíncrono. C# / .NET Activo · Apache-2.0
Shell.Factory Factorías dirigidas por configuración: API fluida, integración con DI, interceptores y creación con seguridad de tipos. C# / .NET Activo · MIT
Shell.Aop AOP sobre el DispatchProxy nativo: logging, reintentos y caché como aspectos reutilizables. C# / .NET Activo · Apache-2.0
Visión de producto E2E de Evolith
Visión de producto E2E de Evolith · abrir el visor interactivo

Good first issues

Mantenemos una lista de entrada curada. Cada issue etiquetado good first issue declara su alcance, los archivos exactos que hay que tocar y los criterios de aceptación que tu PR debe cumplir — sin adivinar nada.

Ver good first issues Ver help wanted

Qué necesitamos ahora mismo:

  • Ingenieros .NET — ampliar la cobertura de pruebas de Shell.* y sacar la siguiente release de las librerías.
  • Ingenieros TypeScript / Node — implementaciones de referencia de los patrones Arc32 en NestJS.
  • Ingenieros de IA — mejorar los conjuntos de instrucciones de AGENTS.md; construir arneses de evaluación para PRs generados por agentes.
  • DevOps — plantillas de CI, imágenes de contenedor y automatización de releases en toda la organización.
  • Redactores técnicos — paridad inglés/español en el corpus de ADRs y en la documentación de las librerías.

¿No encuentras un issue que encaje? Abre uno o inicia una discusión — las propuestas son bienvenidas antes del código.

Tu primera contribución, en 4 pasos

# 1. Haz fork y clona
gh repo fork beyondnetcode/evolith_arch32 --clone

# 2. Crea la rama (commitlint valida el nombre)
git checkout -b feat/tu-cambio

# 3. Commit — Conventional Commits, validados por husky
git commit -m "feat(reference): add ADR for outbox pattern"

# 4. Push y abre el PR
gh pr create --fill

Lee CONTRIBUTING.es.md (EN) una vez — cubre las compuertas de gobernanza, el proceso de ADR y cómo proponer un cambio a un estándar.

Cómo decidimos

Los cambios de arquitectura pasan por ADRs, no por opiniones. Cualquiera puede proponer uno; los mantenedores lo revisan contra el corpus en reference/. El desacuerdo se espera y se documenta — para eso se escriben las decisiones.

Contribuyentes

"El código va más allá de la sintaxis; es la arquitectura del futuro. Constrúyela con nosotros."

Mantenido por Alberto Arroyo Raygada y quienes contribuyen · Discussions