Cuando trabajamos con Scriptcase, conocer la estructura de sus carpetas es fundamental para administrar correctamente el entorno de desarrollo, entender dónde se almacenan los recursos clave y asegurar un manejo adecuado de la configuración y los datos. Esta guía reúne toda la información necesaria para explorar y comprender las carpetas que forman parte de una instalación típica de Scriptcase.
Estructura principal tras la instalación
app/
Esta carpeta contiene todo lo relacionado con las aplicaciones generadas en Scriptcase, incluyendo código fuente, bibliotecas, temas, lenguajes, imágenes, entre otros. Es importante destacar que esta carpeta está destinada únicamente para desarrollo y vista previa, no debe utilizarse para copias de seguridad ni para entornos de producción.
Subcarpetas importantes dentro de app/<nombre_proyecto>/_lib:
- buttons/: Temas de botones.
- chart/: Temas gráficos y código PHP para gráficos.
- css/: Temas de las aplicaciones.
- font/: Fuentes para PDFs y captchas.
- friendly_url/: Direcciones amigables de las aplicaciones.
- googlefonts/: Fuentes de Google utilizadas en los temas.
- img/: Imágenes de las aplicaciones (botones, fondos, íconos, etc.).
- js/: Notificaciones y mensajes de JavaScript.
- lang/: Mensajes de idioma para las aplicaciones.
- lib/: Recursos internos de Scriptcase.
- libraries/: Bibliotecas externas específicas del proyecto.
- menuicons/: Íconos utilizados en los menús.
- oauth/: Archivos de autenticación para APIs como Google Calendar.
Librerías en <nombre_proyecto>/_lib/libraries:
- grp/: Nivel del proyecto.
- scriptcase/: Nivel general de Scriptcase.
- sys/: Nivel público.
- usr/: Nivel específico del usuario.
backup/
Contiene todas las exportaciones importadas a Scriptcase, como proyectos y copias de seguridad. En instalaciones estándar que utilizan SQLite, esta carpeta incluye la base de datos de Scriptcase.
devel/
Es el núcleo del entorno de desarrollo de Scriptcase. Aquí se almacenan configuraciones, plantillas, bibliotecas, imágenes, y recursos específicos de cada proyecto, usuario o nivel público.
Subcarpetas clave en devel/:
- conf/scriptcase/:
nm_scriptcase.db: Base de datos SQLite para instalaciones estándar.scriptcase.config.php: Configuración administrativa.api/: Perfiles de API.tpl/: Plantillas HTML (encabezados, pies, etc.).img/: Imágenes generales, como fondos, botones e íconos.libraries/: Bibliotecas externas.snippets/: Fragmentos reutilizables de código.
- conf/<nombre_proyecto>/:
- Contiene configuraciones específicas del proyecto, como temas de gráficos, fuentes de Google y plantillas HTML.
- conf/sys/:
- Recursos públicos, como temas, imágenes y plantillas compartidas entre proyectos.
- conf/usr/<usuario>/:
- Configuraciones personalizadas para cada usuario.
doc/
Directorio que contiene la documentación oficial de Scriptcase.
examples/
Incluye proyectos de ejemplo y scripts SQL para bases de datos SQLite y MySQL.
file/
Directorio donde se almacenan archivos subidos mediante campos de tipo documento o imagen. Su uso se limita a pruebas en el entorno de desarrollo.
log/
Guarda los registros generados por Scriptcase, como logs de actualizaciones, acciones de usuarios y correcciones automáticas.
Estructura:
- iface/: Registra las acciones realizadas por los usuarios.
- upd/: Logs de actualizaciones automáticas.
- fix.log: Registros de correcciones aplicadas tras actualizaciones.
prod/
Directorio que contiene el entorno de producción. Este es utilizado para gestionar conexiones y librerías necesarias para los proyectos publicados.
Subcarpetas importantes:
- cep/: Archivos para búsquedas relacionadas con códigos postales (disponible solo en configuraciones específicas).
- third/: Librerías de terceros empleadas en las aplicaciones.
tmp/
Directorio temporal donde Scriptcase almacena archivos generados durante el uso, como logs, exportaciones y datos intermedios.
Resumen de niveles de configuración
La estructura de carpetas en Scriptcase está diseñada para separar los recursos según su nivel de uso:
- Nivel Scriptcase (
devel/conf/scriptcase): Recursos compartidos entre todos los proyectos y usuarios. - Nivel Proyecto (
devel/conf/grp/<nombre_proyecto>): Configuraciones específicas de cada proyecto. - Nivel Público (
devel/conf/sys): Recursos accesibles por cualquier usuario. - Nivel Usuario (
devel/conf/usr/<usuario>): Configuraciones y recursos individuales.
Consideraciones finales
Es esencial entender esta estructura para garantizar un flujo de trabajo eficiente y organizado en Scriptcase. Además, siguiendo las mejores prácticas de desarrollo, se recomienda:
- Mantener copias de seguridad periódicas fuera del directorio de Scriptcase.
- Evitar la manipulación directa de archivos en producción.
- Actualizar regularmente los recursos compartidos para optimizar el rendimiento.
Con esta guía detallada, podrás navegar y administrar el entorno de desarrollo de Scriptcase de manera efectiva, asegurando un manejo adecuado de tus proyectos y configuraciones.