TACTIC Rules

...

TACTIC Backend - SKILL.md

🔧 Análisis Técnico Detallado del Backend

Este documento proporciona un análisis exhaustivo del backend TACTIC, detallando cada componente, tecnologías y arquitectura para facilitar el desarrollo, mantenimiento y extensión del sistema.

🏛️ Arquitectura del Core Framework

1. pyasm/ - Framework de Bajo Nivel (Foundation Layer)

pyasm/search/ - Motor de Búsqueda y ORM

Propósito: Proporcionar una capa de abstracción de base de datos y ORM potente.

Clases Principales:

Clases fundamentales del ORM

• SObject # Clase base para todos los objetos de datos
• Search # Motor de consultas con filtros avanzados
• SearchType # Definición de tipos de búsqueda y esquemas
• DatabaseImpl # Abstracción de base de datos multi-vendor
• Transaction # Sistema de transacciones ACID
• SearchKey # Identificador único de objetos
• ColumnFilter # Sistema de filtros de columnas

Funcionalidades Clave:

• ORM Completo: Mapeo objeto-relacional con relaciones complejas

• Multi-Database: PostgreSQL, MySQL, SQLite, SQL Server

• Query Builder: Construcción dinámica de consultas SQL

• Transaction Management: ACID transactions con rollback

• Caching: Query cache y object cache

• Schema Migration: Migraciones automáticas de esquemas

• Audit Trail: Logging automático de cambios

Patrones Implementados:

• Active Record Pattern

• Unit of Work Pattern

• Data Mapper Pattern

pyasm/web/ - Framework Web y Widget System

Propósito: Proporcionar infraestructura web y sistema de componentes UI.

Clases Principales:

Core Web Framework

• WebContainer # Gestor de contexto web y estado global
• WebState # Estado de la aplicación web
• AppServer # Servidor de aplicaciones base
• WebEnvironment # Gestión de entorno web
• WebInit # Inicialización del framework

Widget System

• Widget # Clase base de todos los widgets
• HtmlWdg # Generador de HTML
• BaseRefreshWdg # Widget base con capacidad de refresh
• WebApp # Aplicación web principal

Funcionalidades Clave:

• Widget Hierarchy: Sistema de widgets jerárquico anidable

• State Management: Gestión de estado entre peticiones

• Session Management: Manejo de sesiones de usuario

• Request Routing: Sistema de ruteo flexible

• Template Engine: Integración con Mako templates

• AJAX Support: Comunicación asíncrona integrada

Patrones Implementados:

• Composite Pattern (para widgets)

• Observer Pattern (para eventos)

• Template Method Pattern

pyasm/biz/ - Lógica de Negocio Core

Propósito: Implementar la lógica de negocio fundamental del sistema.

Clases Principales:

Core Business Objects

• Project # Gestión de proyectos y configuración
• Task # Gestión de tareas y asignaciones
• Pipeline # Definición de flujos de trabajo
• Snapshot # Versionado de archivos y metadatos
• File # Gestión de archivos físicos
• Note # Sistema de notas y comentarios
• Search # Búsquedas guardadas y filtros

Funcionalidades Clave:

• Project Management: Creación y gestión de proyectos

• Workflow Engine: Ejecución de pipelines y procesos

• File Versioning: Sistema de versionado de archivos

• Metadata Management: Gestión de metadatos extensibles

• Task Automation: Automatización de tareas recurrentes

pyasm/security/ - Sistema de Seguridad

Propósito: Proporcionar autenticación, autorización y gestión de accesos.

Clases Principales:

• Security # Gestor de seguridad central
• Authenticate # Sistema de autenticación
• AccessManager # Control de accesos por roles
• Login # Gestión de usuarios
• Group # Gestión de grupos
• Batch # Procesamiento por lotes seguro

Funcionalidades Clave:

• Multi-factor Authentication: Soporte para múltiples métodos

• Role-based Access Control (RBAC): Control granular de accesos

• Ticket-based Authentication: Sistema de tickets con expiración

• Access Rules: Reglas de acceso configurables

• Audit Logging: Registro de actividades de seguridad

pyasm/command/ - Sistema de Comandos

Propósito: Implementar el patrón Command para operaciones ejecutables.

Clases Principales:

• Command # Clase base de comandos
• CommandDelegator # Ejecutor de comandos
• Trigger # Sistema de triggers y eventos

Funcionalidades Clave:

• Undo/Redo Support: Soporte para deshacer/rehacer

• Command Chaining: Encadenamiento de comandos

• Async Execution: Ejecución asíncrona de comandos

• Error Handling: Manejo robusto de errores

2. tactic/ - Framework de Alto Nivel

tactic/ui/ - Componentes UI Avanzados

Propósito: Proporcionar widgets especializados y componentes de UI empresariales.

Módulos Principales:

Advanced UI Components

• table/ # Tablas de datos con sorting, filtering, pagination
• panel/ # Paneles y layouts complejos
• widget/ # Widgets especializados (forms, calendars, etc.)
• filter/ # Filtros de búsqueda avanzados
• tool/ # Herramientas administrativas
• app/ # Aplicaciones completas

Widgets Clave:

• TableWdg: Tablas con capacidades empresariales

• FilterWdg: Filtros dinámicos y guardables

• EditWdg: Formularios de edición complejos

• CalendarWdg: Calendarios interactivos

• ChartWdg: Gráficos y visualizaciones

tactic/protocol/ - APIs y Protocolos

Propósito: Exponer funcionalidad del sistema através de diversas APIs.

Handlers Principales:

• APIRestHandler # API REST principal
• SObjectRestHandler # Handler específico para objetos
• GraphQLHandler # Soporte GraphQL
• PythonRestHandler # API con scripts Python
• XMLRPCHandler # Handler XML-RPC tradicional

Funcionalidades:

• RESTful API: API completa con métodos CRUD

• GraphQL: Queries flexibles y eficientes

• Authentication: Integración con sistema de seguridad

• Rate Limiting: Control de rate limiting y throttling

• Documentation: Auto-documentación de endpoints

tactic/startup/ - Inicialización del Sistema

Propósito: Gestionar el startup y shutdown del sistema.

Componentes:

• TacticInit: Inicialización principal del framework

• PluginLoader: Carga de plugins y módulos

• DatabaseUpgrade: Migraciones automáticas de base de datos

🗄️ Sistema de Base de Datos Detallado

Esquema Principal (sthpw/)

Tablas del Sistema

-- Core System Tables CREATE TABLE project ( code VARCHAR(256) PRIMARY KEY, title VARCHAR(256), description TEXT, project_type VARCHAR(256), status VARCHAR(256), -- Configuration y metadata );

CREATE TABLE "login" ( code VARCHAR(256) PRIMARY KEY, login VARCHAR(256) UNIQUE, password VARCHAR(256), first_name VARCHAR(256), last_name VARCHAR(256), email VARCHAR(256), -- Security y preferences );

CREATE TABLE task ( code VARCHAR(256) PRIMARY KEY, search_type VARCHAR(256), search_id INTEGER, process VARCHAR(256), status VARCHAR(256), assigned VARCHAR(256), -- Timestamps y metadata );

CREATE TABLE snapshot ( code VARCHAR(256) PRIMARY KEY, search_type VARCHAR(256), search_id INTEGER, context VARCHAR(256), version INTEGER, description TEXT, -- File references );

Relaciones y Claves Foráneas

• Project -> Task: Un proyecto tiene múltiples tareas

• Task -> Snapshot: Las tareas tienen múltiples snapshots

• Login -> Task: Los usuarios están asignados a tareas

• SearchType -> SObject: Tipos de búsqueda definen esquemas dinámicos

Sistema de Configuración XML

Definición de SObject

<!-- src/config/sthpw/sobject/project.xml --> <search_type name="project"> <column name="code" type="string" key="true"/> <column name="title" type="string"/> <column name="description" type="text"/> <column name="project_type" type="string"/> <column name="status" type="string"/> <column name="metadata" type="text"/>

<!-- Relationships -->
<relationship type="has_many" to="task" on="project_code"/>
<relationship type="has_many" to="snapshot" on="project_code"/>

</search_type>

🔌 Sistema de Plugins

Arquitectura de Plugins

plugins/ ├── tactic_enterprise/ # Plugin empresarial ├── tactic_vfx/ # Plugin VFX especializado ├── custom_widgets/ # Widgets personalizados └── third_party/ # Integraciones de terceros

Plugin Manager

• PluginLoader: Carga dinámica de plugins

• DependencyManager: Gestión de dependencias entre plugins

• PluginRegistry: Registro central de plugins activos

🚀 Sistema de Ejecución y Despliegue

Startup Sequence

1. Inicialización del entorno

TacticInit.set_environment()

2. Carga de configuración

Config.load_config()

3. Inicialización de base de datos

DatabaseInit.initialize()

4. Carga de plugins

PluginLoader.load_plugins()

5. Inicialización de web framework

WebContainer.start()

Process Management

• Multiprocessing: Soporte para múltiples procesos workers

• Thread Pool: Pool de threads para handling concurrente

• Load Balancing: Configuración de balanceo de carga

🔧 Configuración Avanzada

Database Pool Configuration

<database> <vendor>PostgreSQL</vendor> <server>localhost</server> <port>5432</port> <user>postgres</user> <password>encrypted_password</password> <pool_max_connections>20</pool_max_connections> <pool_min_connections>5</pool_min_connections> <connection_timeout>30</connection_timeout> </database>

Security Configuration

<security> <version>2</version> <ticket_expiry>10 hour</ticket_expiry> <max_failed_attempts>5</max_failed_attempts> <lockout_duration>30 minutes</lockout_duration> <password_policy>strong</password_policy> <session_timeout>8 hours</session_timeout> </security>

📊 Performance Optimizations

Query Optimization

• Index Strategy: Índices automáticos basados en patrones de consulta

• Query Cache: Caching de consultas frecuentes

• Connection Pooling: Pool de conexiones optimizado

• Lazy Loading: Carga diferida de relaciones

Memory Management

• Object Pooling: Reutilización de objetos frecuentes

• Garbage Collection: Tuning de GC para Python

• Memory Profiling: Herramientas de profiling integradas

🔄 Patrones de Diseño Avanzados

Event-Driven Architecture

Sistema de eventos central

class EventManager: @staticmethod def register_handler(event_type, handler): # Registro de event handlers

@staticmethod
def trigger_event(event_type, data):
    # Disparo de eventos

Plugin Architecture

• Strategy Pattern: Plugins implementan diferentes estrategias

• Observer Pattern: Plugins observan eventos del sistema

• Factory Pattern: Creación dinámica de componentes de plugins

🔍 Monitoring y Debugging

Logging System

Logging jerárquico por componente

import logging

Business logic logging

business_logger = logging.getLogger('pyasm.biz')

Security logging

security_logger = logging.getLogger('pyasm.security')

Performance logging

perf_logger = logging.getLogger('pyasm.performance')

Performance Metrics

• Response Times: Métricas de tiempo de respuesta

• Database Queries: Estadísticas de consultas

• Memory Usage: Monitoreo de consumo de memoria

• Error Rates: Tasas de error por componente

🧪 Testing Framework

Unit Tests

Estructura de tests

class TestSObject(unittest.TestCase): def setUp(self): # Setup test database

def test_create_sobject(self):
    # Test de creación de objetos
    
def test_query_with_filter(self):
    # Test de consultas con filtros

Integration Tests

• API Tests: Testing de endpoints REST

• Database Tests: Testing de operaciones CRUD

• Workflow Tests: Testing de pipelines complejos

🔒 Security Considerations

Authentication Flow

Flujo de autenticación

1. User provides credentials
2. Authenticate.validate_credentials()
3. Security.create_ticket(login_name)
4. Return login ticket
5. Subsequent requests validate ticket

Authorization Matrix

• Resource-based: Control por recurso específico

• Role-based: Control por roles de usuario

• Attribute-based: Control por atributos dinámicos

🚀 Escalabilidad Considerations

Horizontal Scaling

• Load Balancer: Configuración de balanceo de carga

• Database Replication: Replicación de base de datos

• Cache Layer: Capa de caché distribuida

Vertical Scaling

• Memory Optimization: Optimización de uso de memoria

• CPU Optimization: Optimización de CPU-bound operations

• I/O Optimization: Optimización de operaciones de I/O

Este documento técnico detalla completamente el backend TACTIC, proporcionando el contexto necesario para desarrollo, mantenimiento y extensión del sistema.