Andres glastor-dev

GLASTOR® — Ingeniería de backend y arquitectura

Ingeniero de backend en Python · Arquitecto de API · Automatización y DevOps

Note

⚡ Autonomous Living Profile: Este perfil es un artefacto de ingeniería vivo, autogenerado y validado en tiempo real con análisis AST de TypeScript, auditoría 4R (Risk, Readability, Reliability, Resilience) y despliegue continuo de su documentación técnica a GitHub Pages (mdBook).

🟢 Disponible para proyectos — Próximas aperturas: Noviembre 2026

🏢 GLASTOR® Core • 📖 Documentación Técnica (mdBook) • 📦 JSR Package • 📧 Contacto • 📁 Portfolio • 🎥 Demo

👋 Sobre mí

Desarrollo APIs REST de alto rendimiento y herramientas de automatización con Python para equipos de producto en producción. Más de 15 años creando soluciones backend escalables para empresas tecnológicas.

Fundador y Lead Architect en GLASTOR® Core — Especializado en arquitectura backend, DevOps, motores de análisis estático y soluciones técnicas que reducen costos operativos hasta un 40%.

"Andres entregó una solución de API que maneja 5,000 req/s con latencia p99 < 50ms. Su trabajo redujo nuestros costos de infraestructura significativamente."
— Dan Khasis
Chief Executive Officer and Founder, Route4Me

💼 Especialidades técnicas

✅ Backend Python — APIs con FastAPI y Django, optimizadas para alto tráfico (5K+ req/s)
✅ DevOps & CI/CD — Pipelines robustos que reducen deployment time 75% (30min → 7min)
✅ Contenedores — Arquitecturas Docker que facilitan escalado horizontal automático
✅ Git avanzado — Flujos de trabajo con GitKraken, pair programming y code review efectivo

🔭 Actualmente trabajando en

🚀 Ecosistema Deno 2 & JSR — Generador de READMEs de alto rendimiento con análisis AST y plugins modulares (@glastor-dev/readmegen)
🤖 Herramientas AI-Ready — Integración nativa del estándar llms.txt y pipelines de automatización
🧪 Smart injection engine — Template engine inteligente que reduce boilerplate 60%
📝 Contenido técnico — Serie sobre arquitectura de APIs, optimización p99 y patrones backend
🤝 Open Source — Aceptando contribuciones en herramientas de developer experience (ver CONTRIBUTING)

✨ Disponible para

Consultoría técnica en arquitectura de APIs y optimización de rendimiento
Code review y auditoría de seguridad en proyectos Python/FastAPI
Desarrollo de tooling interno, CLI tools y automatizaciones
Technical writing y documentación de APIs
Proyectos Open Source — Issues y PRs bienvenidos

🛠️ Stack Tecnológico

Backend & Lenguajes:

Frameworks & APIs:

DevOps & Cloud:

Databases & Tools:

🎓 Certificaciones & Aprendizaje

🏆 AWS Solutions Architect & DevOps Specialist (Arquitecturas cloud y microservicios)
📚 Especialización continua: Kubernetes (CKA), Advanced PostgreSQL Performance Tuning
🎯 Enfoque técnico: FastAPI patterns, AsyncIO, Distributed systems, AI Agents

📊 GitHub Stats & Activity

📈 Ver métricas completas e historial de actividad

💙 Sponsors & Colaboradores

Empresas que apoyan financieramente el desarrollo de herramientas Open Source:

Nexperia _{Automatización de pipeline de testing para semiconductores}	Aspid Cars _{Sistema de gestión de inventario y logística}	Rizin _{Contribuciones a reverse engineering framework}
Route4Me _{API de geolocalización y routing en tiempo real}	Neovim _{Plugins y contribuciones al ecosistema}	¿Tu empresa? _{Apoya el desarrollo Open Source}

Impacto comprobado: +15 años en producción • Arquitecturas de 5K+ req/s (p99 < 50ms) • Hasta 40% ahorro en infraestructura

🤝 Convertirte en Sponsor

Tu apoyo permite dedicar más tiempo al desarrollo de herramientas Open Source de calidad profesional.

📄 Coordenadas para transferencia bancaria directa (USD / ARS)

Para transferencias directas ACH (USD), wire internacional o transferencias locales (ARS / Galicia):
👉 Solicitar datos bancarios vía email

Se proporcionan de forma privada para mayor seguridad y emisión de la factura/recibo correspondiente.

Beneficios según tier:

Tier	Inversión/mes	Beneficios
🥉 Bronze	10 USD	Logo en README • Mención en releases
🥈 Silver	50 USD	Todo anterior + Prioridad en issues • Acceso temprano a features
🥇 Gold	100 USD	Todo anterior + 2h consultoría/mes • Code review prioritario
💎 Platinum	500 USD	Todo anterior + Feature requests dedicados • Soporte 24/7
🏢 Enterprise	Custom	Soluciones a medida • SLA garantizado • Desarrollo privado

ROI para empresas:

🎯 Visibilidad ante 50K+ developers activos
🔧 Acceso prioritario a herramientas que aumentan productividad
🤝 Relación directa con maintainer experimentado
📈 Soporte para herramientas críticas en tu stack

📧 Contactar para plan Enterprise

🏆 Contributors Hall of Fame:

Agradecemos a todos nuestros contributors:

Ver todos los contributors →

📫 Contacto & Enlaces

💼 Disponible para proyectos freelance, consultoría técnica y colaboraciones
📧 Tiempo de respuesta promedio: < 24 horas (normalmente < 6h)
🗓️ Agendar llamada de 30min (gratis, sin compromiso)

🔗 Más recursos:

🌐 Website

📖 Documentación Técnica & Arquitectura (Motor Autónomo)

💡 Portal Completo de Arquitectura: Accede al manual técnico completo, diagramas de módulos y guías en el portal oficial: glastor-dev.github.io/glastor-dev

API Reference

Core Generators & Review Tools

generateReadme(args: GenerateReadmeArgs): Promise<string>
// Generador principal de README con análisis completo de proyecto

generateMermaidGraph(projectRoot: string): Promise<string>
// Grafo de módulos y dependencias de arquitectura en formato Mermaid

generateLlmsTxt(analysis: ProjectAnalysis): string
// Generador del estándar llms.txt para agentes y LLMs

calculateDocCoverage(exports: ExportInfo[]): DocCoverageResult
// Auditoría de cobertura de documentación JSDoc y badges

reviewFile(filePath: string, content: string): FileReview
// Auditoría de código bajo 4Rs: Risk, Readability, Reliability, Resilience

generateBadges(_config: BadgesConfig): string
// Genera badges dinámicos basados en project config

generateApiDocs(exports: ExportInfo[]): string
// Documenta exports automáticamente desde análisis AST

generateToc(options: TocOptions): string
// Tabla de contenidos con links automáticos

Project Analysis

analyzeProject(options: AnalyzeProjectOptions): Promise<ProjectAnalysis>
// Análisis completo: estructura, deps, tests, workflows

extractExports(filePath: string): Promise<ExportInfo[]>
// Extrae exports de archivos TS/JS con tipos y JSDoc

detectTests(projectRoot: string): Promise<TestDetection>
// Detecta frameworks de testing y coverage

readDenoConfig(projectRoot: string): Promise<DenoConfig>
// Lee y parsea deno.json/deno.jsonc

Utilities

sanitizeGeneratedMarkdown(markdown: string): string
// Limpia y normaliza markdown generado

loadUserConfig(projectRoot: string): Promise<UserConfig>
// Carga configuración de usuario desde .readmegen.json

ensureWritableOutput(path: string, options: WriteOptions): Promise<void>
// Valida permisos y crea directorio si necesario

Ver docs completas: API Documentation

📦 Dependencies & Tech Stack

Runtime Requirements

Deno >= 2.1.0 (recommended: latest stable)
TypeScript 5.x (bundled with Deno)
Node.js 18+ (optional, for npm packages)

Core Dependencies (JSR)

Standard Library:

{
  "@std/assert": "^1.0.0", // Testing assertions
  "@std/fs": "^1.0.0", // File system operations
  "@std/path": "^1.0.0", // Path manipulation
  "@std/jsonc": "^1.0.0" // JSON with comments parser
}

CLI Framework:

{
  "@cliffy/command": "1.0.0-rc.7", // Command-line framework
  "@cliffy/prompt": "1.0.0-rc.7", // Interactive prompts
  "@cliffy/ansi": "1.0.0-rc.7" // Terminal colors & formatting
}

Third-party (npm)

{
  "typescript": "^5.7.0" // TypeScript Compiler AST API (offline, zero WASM)
}

Optional Integrations

Pandoc — Para export a PDF/DOCX
Playwright — Para screenshots automáticos
Sharp — Image optimization

Installation & Usage:

# Via Deno 2 (JSR)
deno install -g -A -n readmegen jsr:@glastor-dev/readmegen

# O ejecución directa sin instalación previa:
deno run -A jsr:@glastor-dev/readmegen

🔧 Development Setup & Toolbox

🖥️ Entorno de Desarrollo

Sistemas Operativos:

🐧 Arch Linux (principal) — Kernel 6.x custom
- Terminal: Xterm + Zsh + Oh-My-Zsh
- WM: i3-gaps con Polybar
- Terminal alternativo: eDEX-UI (cyberpunk style)
🪟 Windows 10 Pro (testing)
- Terminal: Windows Terminal + Git Bash
- WSL2: Ubuntu 22.04 LTS

Editores & IDEs:

💻 VS Code (principal) — Extensions:
- Python, Deno, ESLint, Prettier
- GitLens, Docker, Thunder Client
- Quimera Theme (propio)
⚡ Neovim — Para edición rápida y remota
- Config: LazyVim + custom plugins
- LSP: pyright, tsserver, rust-analyzer

Version Control:

🦑 GitKraken PRO — GUI para operaciones complejas
🔧 Git CLI — Para automation y scripts
📊 GitHub Desktop — Para quick commits

🎯 Áreas de Especialización

Backend & APIs:

FastAPI patterns & best practices
Django REST Framework optimization
GraphQL con Strawberry/Ariadne
gRPC con Python

DevOps & Infrastructure:

Docker multi-stage builds
Docker Compose orchestration
GitHub Actions workflows
AWS (EC2, Lambda, RDS, S3)
Terraform (IaC)

Security & Cryptography:

OWASP Top 10 mitigation
JWT/OAuth2 implementation
Encryption (AES, RSA)
Penetration testing basics
Secure coding practices

AI/ML & Automation:

Prompt Engineering (GPT-4, Claude)
LangChain for AI workflows
OpenAI API integration
Automation scripts (Python, Bash)
Web scraping (Beautiful Soup, Scrapy)

Documentation & Technical Writing:

API documentation (OpenAPI/Swagger)
Technical blog writing
Video tutorial creation
Code documentation standards

📚 Lecturas & Formación Continua

Libros técnicos recientes:

✅ The Pragmatic Programmer (20th Anniversary)
✅ Clean Architecture — Robert C. Martin
✅ Designing Data-Intensive Applications — Martin Kleppmann
📖 Building Microservices (2nd ed.) — En progreso
📖 Site Reliability Engineering — Google (En progreso)

Cursos & Certificaciones en proceso:

🎓 AWS Solutions Architect Associate (Completado)
🎓 Certified Kubernetes Administrator (CKA) (En preparación)
📚 FastAPI Advanced Patterns & AI Agent Architectures

Podcasts favoritos:

🎙️ Talk Python To Me
🎙️ Python Bytes
🎙️ The Changelog
🎙️ Software Engineering Daily

📋 Políticas del Proyecto

📞 Soporte • 🔒 Seguridad • ⚖️ Código de Conducta • 📜 Licencia

2025 GLASTOR® marca registrada en Argentina (INPI)
Reg. 4559568 (Clase 42) y 4559567 (Clase 35) — Fecha: 19/08/2025

Licencia Dual:

Código de la herramienta: Licenciado bajo GNU GPL v3.0
Textos generados y plantillas: Licenciados bajo Creative Commons Attribution 4.0 (CC BY 4.0)

_{🤖 README generado automáticamente • Versión 2.2.0 • Última actualización: 2026-10-19}
_{⭐ Si este proyecto te fue útil, considera darle una estrella en GitHub}

📖 API Documentation

scripts/code_review.ts

calculateReviewResult

Type: function
Signature: calculateReviewResult(findings: Finding[], filesAnalyzed: string[]): ReviewResult

Finding

Type: interface

formatMarkdown

Type: function
Signature: formatMarkdown(result: ReviewResult): string

formatTerminal

Type: function
Signature: formatTerminal(result: ReviewResult): string

Pillar

Type: type

PillarScore

Type: interface

reviewFile

Type: function
Signature: reviewFile(filePath: string, content: string): Finding[]

ReviewResult

Type: interface

Severity

Type: type

src/generators/api.ts

generateApiDocs

Type: function
Signature: generateApiDocs(exports: ExportInfo[], projectRoot: string = Deno.cwd()): string

src/generators/badges.ts

BadgesConfig

Type: interface

generateBadges

Type: function
Signature: generateBadges(_config: BadgesConfig): string

generateRepoBadges

Type: function
Signature: generateRepoBadges(config: RepoBadgesConfig): string

generateVisitorBadge

Type: function
Signature: generateVisitorBadge(config: VisitorBadgeConfig): string

RepoBadgesConfig

Type: interface

VisitorBadgeConfig

Type: interface

src/generators/doc_coverage.ts

calculateDocCoverage

Type: function
Signature: calculateDocCoverage(exports: ExportInfo[]): DocCoverageResult

DocCoverageResult

Type: interface

src/generators/examples.ts

ExamplesOptions

Type: interface

ExamplesResult

Type: interface

generateExamples

Type: function (async)
Signature: async generateExamples(projectRoot: string, exports: ExportInfo[], options: ExamplesOptions = {}): Promise<ExamplesResult>

src/generators/llms.ts

generateLlmsTxt

Type: function (async)
Signature: async generateLlmsTxt(options: LlmsTxtOptions): Promise<string>

LlmsTxtOptions

Type: interface

src/generators/mermaid.ts

generateMermaidGraph

Type: function (async)
Signature: async generateMermaidGraph(projectRoot: string, options: MermaidGraphOptions = {}): Promise<string>

MermaidGraphOptions

Type: interface

src/generators/toc.ts

generateToc

Type: function
Signature: generateToc(options: TocOptions): string

TocOptions

Type: interface

src/mod.ts

generateReadme

Generates the README documentation for the project by analyzing AST and rendering templates.

Type: function (async)
Signature: async generateReadme(args: GenerateReadmeArgs): Promise<void>
Params:
- args - Configuration options including template style, output file, and force flag.
Returns - A promise that resolves when the README and related artifacts are generated.

await generateReadme({ template: "modern", output: "README.md", force: true });

GenerateReadmeArgs

Arguments for generating the project README

Type: interface

sanitizeGeneratedMarkdown

Normalizes and cleans generated Markdown text by stripping BOM, removing accidental trash code, and ensuring banner images are positioned at the document header.

Type: function
Signature: sanitizeGeneratedMarkdown(markdown: string): string
Params:
- markdown - Raw generated markdown content.
Returns - Cleaned and sanitized markdown string.

TemplateName

Supported README template styles

Type: type

src/parsers/deno_json.ts

DenoConfig

Type: interface

readDenoConfig

Type: function (async)
Signature: async readDenoConfig(projectRoot: string): Promise<DenoConfig | null>

src/parsers/import_map.ts

ImportMap

Type: interface

readImportMap

Type: function (async)
Signature: async readImportMap(projectRoot: string): Promise<ImportMap | null>

src/parsers/imports.ts

analyzeImports

Type: function (async)
Signature: async analyzeImports(projectRoot: string, options: AnalyzeImportsOptions = {}): Promise<ImportAnalysis>

AnalyzeImportsOptions

Type: interface

ImportAnalysis

Type: interface

src/parsers/project_files.ts

detectProjectFiles

Type: function (async)
Signature: async detectProjectFiles(projectRoot: string): Promise<string[]>

src/parsers/source_code.ts

ExportInfo

Type: interface

ExportType

Type: type

extractExports

Type: function (async)
Signature: async extractExports(filePath: string): Promise<ExportInfo[]>

extractExportsFromProject

Type: function (async)
Signature: async extractExportsFromProject(projectRoot: string, options: ExtractOptions = {}): Promise<ExportInfo[]>

ExtractOptions

Type: interface

JSDocParam

Type: interface

src/parsers/source_code_ast.ts

extractExportsAst

Type: function (async)
Signature: async extractExportsAst(filePath: string): Promise<ExportInfo[]>

extractExportsAstFromCode

Type: function
Signature: extractExportsAstFromCode(code: string, filePath: string): ExportInfo[]

JSDocInfo

Type: interface

src/parsers/workflows.ts

detectWorkflows

Type: function (async)
Signature: async detectWorkflows(projectRoot: string): Promise<string[]>

src/project/analyze.ts

analyzeProject

Type: function (async)
Signature: async analyzeProject(options: AnalyzeProjectOptions): Promise<ProjectAnalysis>

AnalyzeProjectOptions

Type: interface

ProjectAnalysis

Type: interface

TemplateData

Type: interface

src/utils/file_system.ts

ensureWritableOutput

Type: function (async)
Signature: async ensureWritableOutput(outputPath: string, options: { force: boolean }): Promise<void>

src/utils/init_wizard.ts

runInitWizard

Type: function (async)
Signature: async runInitWizard(projectRoot: string)

src/utils/logger.ts

Logger

Type: const
Signature: const Logger

src/utils/readme_infer.ts

inferDescriptionFromReadme

Type: function (async)
Signature: async inferDescriptionFromReadme(readmePath: string): Promise<string | null>

src/utils/user_config.ts

loadUserConfig

Type: function (async)
Signature: async loadUserConfig(projectRoot: string): Promise<UserConfig>

UserConfig

Type: interface

📦 Dependencies

Config files

deno.json/deno.jsonc
import_map.json

Project files

Dockerfile
LICENSE

Standard Library

jsr:@std/fs@^1.0.0/exists
jsr:@std/fs@^1.0.0/walk
jsr:@std/jsonc@^1.0.0/parse
jsr:@std/path@^1.0.0/dirname
jsr:@std/path@^1.0.0/extname
jsr:@std/path@^1.0.0/glob-to-regexp
jsr:@std/path@^1.0.0/join
jsr:@std/path@^1.0.0/relative

Third-party

jsr:@cliffy/ansi@1.0.0-rc.7/colors
jsr:@cliffy/command@1.0.0-rc.7
jsr:@cliffy/prompt@1.0.0-rc.7
npm:typescript@^5.7.0

📐 Architecture & Module Graph

graph TD
    src_generators_api_ts["src/generators/api.ts"]
    src_parsers_source_code_ts["src/parsers/source_code.ts"]
    src_generators_badges_ts["src/generators/badges.ts"]
    src_generators_doc_coverage_ts["src/generators/doc_coverage.ts"]
    src_generators_examples_ts["src/generators/examples.ts"]
    src_generators_llms_ts["src/generators/llms.ts"]
    src_parsers_deno_json_ts["src/parsers/deno_json.ts"]
    src_utils_user_config_ts["src/utils/user_config.ts"]
    src_generators_mermaid_ts["src/generators/mermaid.ts"]
    src_generators_toc_ts["src/generators/toc.ts"]
    src_main_ts["src/main.ts"]
    src_mod_ts["src/mod.ts"]
    src_utils_init_wizard_ts["src/utils/init_wizard.ts"]
    src_utils_logger_ts["src/utils/logger.ts"]
    src_project_analyze_ts["src/project/analyze.ts"]
    src_templates_load_ts["src/templates/load.ts"]
    src_templates_render_ts["src/templates/render.ts"]
    src_utils_file_system_ts["src/utils/file_system.ts"]
    src_parsers_imports_ts["src/parsers/imports.ts"]
    src_parsers_import_map_ts["src/parsers/import_map.ts"]
    src_parsers_project_files_ts["src/parsers/project_files.ts"]
    src_parsers_source_code_ast_ts["src/parsers/source_code_ast.ts"]
    src_parsers_workflows_ts["src/parsers/workflows.ts"]
    src_parsers_tests_ts["src/parsers/tests.ts"]
    src_utils_readme_infer_ts["src/utils/readme_infer.ts"]
    src_generators_api_ts --> src_parsers_source_code_ts
    src_generators_doc_coverage_ts --> src_parsers_source_code_ts
    src_generators_examples_ts --> src_parsers_source_code_ts
    src_generators_llms_ts --> src_parsers_deno_json_ts
    src_generators_llms_ts --> src_parsers_source_code_ts
    src_generators_llms_ts --> src_utils_user_config_ts
    src_main_ts --> src_mod_ts
    src_main_ts --> src_utils_init_wizard_ts
    src_main_ts --> src_utils_logger_ts
    src_mod_ts --> src_project_analyze_ts
    src_mod_ts --> src_templates_load_ts
    src_mod_ts --> src_templates_render_ts
    src_mod_ts --> src_utils_file_system_ts
    src_parsers_source_code_ast_ts --> src_parsers_source_code_ts
    src_parsers_source_code_ts --> src_parsers_source_code_ast_ts
    src_project_analyze_ts --> src_generators_api_ts
    src_project_analyze_ts --> src_generators_badges_ts
    src_project_analyze_ts --> src_generators_doc_coverage_ts
    src_project_analyze_ts --> src_generators_examples_ts
    src_project_analyze_ts --> src_generators_llms_ts
    src_project_analyze_ts --> src_generators_mermaid_ts
    src_project_analyze_ts --> src_generators_toc_ts
    src_project_analyze_ts --> src_parsers_deno_json_ts
    src_project_analyze_ts --> src_parsers_import_map_ts
    src_project_analyze_ts --> src_parsers_imports_ts
    src_project_analyze_ts --> src_parsers_project_files_ts
    src_project_analyze_ts --> src_parsers_source_code_ts
    src_project_analyze_ts --> src_parsers_tests_ts
    src_project_analyze_ts --> src_parsers_workflows_ts
    src_project_analyze_ts --> src_utils_readme_infer_ts
    src_project_analyze_ts --> src_utils_user_config_ts
    src_utils_init_wizard_ts --> src_utils_logger_ts