webapp:
La estructura de directorios donde se configura tu aplicación: [/api], [/scripts], [/class] etc.. suelen estar a la altura del <document-root> de tu proyecto. Esto ocurre porque existe una variable de configuración denominada webapp cuyo valor por defecto es [/]
{
"webapp: Default dir of the webapp":"/",
..
}
Si quisiéramos ubicar la estructura de carpetas por defecto en un directorio concreto podríamos indicarlo en esta variable de configuración
Si el valor de [core.api.urls] fuera por ejemplo:
{
"webapp: Default dir of the webapp":"/app-v1",..
}
El framework iría a buscar la estructura de carpetas bajo ese directorio.
Organizando multi-proyectos
Esto es útil porque nos permite por ejemplo organizar estructuras de APIs multi-proyecto en base a condiciones como el dominio de la URL.
{
"domain:{proyecto-1.com}": {
"webapp: Default dir of the webapp":"/project-1"
},
"domain:{proyecto-2.com}": {
"webapp: Default dir of the webapp":"/project-2"
}
En este ejemplo cuando despliegas en producción y configuras tus servidores para responder a dos dominios [proyecto-1.com] y [proyecto-2.com] el fichero de configuración detectará dichos dominios y aplicará la configuración pertinente.
Esto ayuda a organizar mejor la estructura de código de tus proyectos dentro de un mismo sistema de código fuente.