Documentación de Clprolf (1/6) — Declinaciones Explicadas

Clprolf es un lenguaje y marco de trabajo para definir objetos con una única responsabilidad explícita. Al asignar a cada clase una declinación que expresa su rol, se garantiza el cumplimiento del principio de responsabilidad única y se mejora la claridad del diseño incluso cuando hay herencia.

Una declinación define la naturaleza esencial de una clase. Clprolf utiliza pocas declinaciones básicas para mantener el diseño claro e intuitivo. Las cinco declinaciones principales son agent, worker_agent, model, information e indef_obj.

agent representa actores activos del dominio. Variantes y sinónimos habituales incluyen simu_agent, simu_real_world_obj, simu_real_obj y abstraction. Se usa para clases que encapsulan acción, simulaciones de entidades reales o conceptos abstractos como Connection o Socket.

worker_agent describe actores técnicos que ejecutan algoritmos en la máquina; sinónimos: simu_comp_as_worker y comp_as_worker. information es un contenedor de datos coherente, técnico y sin comportamiento de dominio, distinto de model que representa una entidad del mundo real con atributos. indef_obj es una clase flexible sin rol explícito, similar a una clase OO tradicional.

Objetos de negocio son abstractions o agentes orientados al dominio: por ejemplo agent para actores activos, abstraction para conceptos como conexiones y model para entidades pasivas como Customer que solo contienen atributos. Objetos técnicos realizan tareas de soporte: worker_agent para componentes que trabajan en la máquina e information para contenedores de datos, utilidades, repositorios o componentes de vista.

Las declinaciones pueden matizarse con géneros o subroles opcionales y pueden tener sinónimos. Los géneros suelen aplicarse a agent, y hay una marca especial Static que también puede aparecer en worker_agent. Estas refinaciones permiten describir roles como Expert_component o GUI_role manteniendo consistencia terminológica.

Relaciones entre declinaciones: todo agent puede actuar como worker en un contexto de ejecución, pero limitar los workers explícitos mejora la claridad. Un model puede representarse externamente como information para almacenamiento, pero information no debe sustituir a un model cuando lo que se necesita es una entidad del dominio. Sustituciones inversas frecuentes suelen indicar un problema de diseño.

Las interfaces también reciben declinaciones para especificar qué clases pueden implementarlas. Por ejemplo compat_interf_version y compat_interf_capacity definen capacidades e invariantes de implementación. Las interfaces de capacidad pueden incluir un género Advice para indicar si están pensadas para agent o para worker.

Herencia coherente: Clprolf impone que las jerarquías de clases respeten roles. No debe mezclarse en la misma cadena de herencia objetos de negocio con objetos técnicos. Los sinónimos de una declinación son aceptados y, en casos excepcionales, se pueden forzar excepciones con @Forced_inh.

Algoritmo práctico para elegir una declinación: paso 1 identificar si la clase tiene métodos con comportamiento. Si tiene comportamiento elegir agent o worker_agent. Si es pasiva elegir model o information. Paso 2 determinar si la responsabilidad es del negocio o técnica. Lógica de negocio o conocimiento experto implica agent; capas técnicas o de soporte implican worker_agent.

Ejemplo: una clase System vista al principio como worker_agent por su naturaleza técnica puede reconsiderarse como agent cuando representa un componente experto del entorno, o como abstraction si se trata de un concepto del sistema. Un Animal con estados y comportamientos sería una buena candidate para @Agent en una simulación.

Resumen: las declinaciones transforman objetos en componentes con roles explícitos, aclarando responsabilidades, facilitando la lectura del código y asegurando coherencia en la herencia. Los sinónimos ofrecen flexibilidad manteniendo consistencia y ayudan a construir sistemas mantenibles donde cada elemento tiene una posición clara.

En Q2BSTUDIO somos especialistas en desarrollo de software a medida y aplicaciones a medida, combinando buenas prácticas de diseño como Clprolf con tecnologías emergentes. Ofrecemos soluciones de inteligencia artificial, ia para empresas y agentes IA, servicios de ciberseguridad y pentesting, y despliegues en servicios cloud aws y azure. Si buscas desarrollar una aplicación a medida que respete principios de diseño y escalabilidad visita aplicaciones a medida y descubre cómo podemos ayudarte a integrar inteligencia artificial en tus procesos con inteligencia artificial.

Palabras clave integradas naturalmente para mejorar posicionamiento: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi.