Documentación de Joss

Esta documentación describe el comportamiento del código actual. Está separada en aprendizaje, guías, referencia e internos para que una persona nueva pueda avanzar en orden y una persona experimentada encuentre reglas concretas.

Idiomas

• Español (fuente canónica): este directorio.
• English
• Português

Los 50 documentos mantienen el mismo nombre en cada idioma para que los enlaces relativos funcionen igual. Después de editar el español, ejecuta go run ./tools/docsi18n -translate -sync para actualizar traducciones y espejo web; go run ./tools/docsi18n -check detecta archivos ausentes, traducciones desactualizadas, enlaces rotos o diferencias con JosSecurity.

Aprender Joss (Ruta guiada desde cero)

Si nunca has programado o estás aprendiendo Joss por primera vez, sigue este curso en orden. Cada capítulo introduce un concepto a la vez, partiendo desde cómo crear y ejecutar tu proyecto oficial con joss new console, con explicaciones línea por línea, resultados visibles y tres niveles de práctica (Prueba rápida, Ejercicio guiado y Reto).

flowchart LR
    C0["0. Primeros pasos (joss new console)"] --> C1["1. Fundamentos"]
    C1 --> C2["2. Control de flujo"]
    C2 --> C3["3. Colecciones"]
    C3 --> C4["4. Funciones"]
    C4 --> C5["5. Errores"]
    C5 --> C6["6. Clases y POO"]
    C6 --> C7["7. Concurrencia"]
    C7 --> C8["8. Proyecto Consola (joss build)"]
    C8 --> C9["9. Proyecto Web MVC (joss new / joss make:*)"]

1. Primeros pasos: crear tu proyecto con joss new console, entender main.joss y dialogar con cin
2. Valores, variables y operaciones fundamentales
3. Control de flujo: decisiones y ciclos de repetición
4. Colecciones: Arrays, Maps y texto Unicode
5. Funciones, ámbito (scope), guard, defer, closures, ref y pipelines
6. Manejo de errores, diagnósticos JOSS-... y excepciones try/catch
7. Clases, objetos, herencia, interfaces, record y genéricos
8. Concurrencia, async/await, Future y canales (channel)
9. Proyecto práctico de consola con persistencia JSON y joss build
10. Proyecto web completo con joss new y arquitectura MVC nativa

El glosario explica todos los términos de programación y de Joss en lenguaje cotidiano, sin exigir que conozcas otro lenguaje. Una vez completado el curso básico, profundiza en las reglas formales de tipos en Sistema de tipos, inferencia y conversiones.

Referencia del lenguaje y herramientas

• Sintaxis, tokens y precedencia
• Gramática EBNF y nodos AST
• Funciones, recursión y tipos
• Diagnósticos y analizador
• Funciones globales
• Clases nativas y servicios
• Catálogo nativo generado
• CLI, formatter, linter y tests
• Soporte móvil: Android e iOS
• Extensión de VS Code
• Estado y límites

Crear aplicaciones

• Estructura de proyectos y configuración
• Organización sin imports y plugins
• Web: servidor, HTTP/controladores, middleware, vistas, assets y WebSockets
• Datos: modelos/GranDB, Schema Builder y migraciones
• Aplicación: autenticación y SEO/sitemap

Internos y mantenimiento

• Arquitectura del lenguaje
• Guía de contribución
• Auditoría de documentación
• Auditoría del lenguaje Joss 2026
• Evaluación crítica y comparativa de Joss 2026
• Evolución de Joss 2026: fases 0 y 1
• Auditoría del ORM GranDB 2026
• Auditoría técnica de 2026
• Auditoría de optimización runtime
• Novedades históricas 3.6.7

Los documentos históricos conservan contexto y pueden describir el estado de su fecha. Ante una diferencia mandan la implementación, las pruebas y Estado de implementación.