[Alba-desarrollo] SVN Alba r4750 -
prosistem/alba/trunk/alba/doc/manual/xml
commits en pressenter.com.ar
commits en pressenter.com.ar
Vie Jun 15 22:40:56 CEST 2007
Author: verox
Date: 2007-06-15 17:40:55 -0300 (Fri, 15 Jun 2007)
New Revision: 4750
Added:
prosistem/alba/trunk/alba/doc/manual/xml/capitulo_2.xml
prosistem/alba/trunk/alba/doc/manual/xml/capitulo_3.xml
Modified:
prosistem/alba/trunk/alba/doc/manual/xml/capitulo_1.xml
prosistem/alba/trunk/alba/doc/manual/xml/manual.xml
prosistem/alba/trunk/alba/doc/manual/xml/recomendaciones.xml
Log:
cap 2 y 3 nuevos. pendiente revisar imagenes.
Modified: prosistem/alba/trunk/alba/doc/manual/xml/capitulo_1.xml
===================================================================
--- prosistem/alba/trunk/alba/doc/manual/xml/capitulo_1.xml 2007-06-15 19:27:57 UTC (rev 4749)
+++ prosistem/alba/trunk/alba/doc/manual/xml/capitulo_1.xml 2007-06-15 20:40:55 UTC (rev 4750)
@@ -1,5 +1,15 @@
-<chapter><title>Required Chapter</title>
+<chapter><title>Instalacín</title>
<para>
-At least one chapter, reference, part, or article is required in a book.
+
</para>
+
+
+
+
+
+
+
+
+
+
</chapter>
Added: prosistem/alba/trunk/alba/doc/manual/xml/capitulo_2.xml
===================================================================
--- prosistem/alba/trunk/alba/doc/manual/xml/capitulo_2.xml 2007-06-15 19:27:57 UTC (rev 4749)
+++ prosistem/alba/trunk/alba/doc/manual/xml/capitulo_2.xml 2007-06-15 20:40:55 UTC (rev 4750)
@@ -0,0 +1,125 @@
+<chapter><title>Interfaz de ALBA.</title>
+<para>
+La interfaz de ALBA, está compuesta por diversos elementos gráficos con características que se detallan a continuación. Es importante recordar, que como se trata de una aplicación cuyo uso se desenvuelve sobre un navegador, existen muchas funciones de este último que conviven con las de esta aplicación específica.
+</para>
+<sect1> <title>2.1 La pantalla principal de ALBA.</title>
+<para>
+La siguiente pantalla, detalla a modo de ejemplo, los elementos más usuales que la conforman.
+</para>
+<para>
+<figure><title>Elementos de la pantalla principal.</title>
+<graphic fileref="img/figura4.png"/>
+</figure>
+</para>
+
+<para>
+1- Encabezado.
+2- Información actual sobre: usuario, establecimiento y ciclo lectivo.
+3- Barra de menú desplegable.
+4- Título del módulo elegido
+5- Cuerpo del módulo: en este marco se desarrolla cada módulo en particular.
+6- Barra de botones inferiores. (Pueden variar según el módulo mostrado).
+</para>
+</sect1>
+
+<sect1>
+<title>Los elementos más importantes de las pantallas.</title>
+
+<sect2> <title>El menú desplegable.</title>
+ <para>
+Durante el desarrollo completo del uso de la herramienta, se mantiene visible una barra horizontal desde donde se accede a las diferentes secciones del menú. (Ver referencia 3 en el cuadro anterior).
+ </para>
+
+ <para>
+Al pasar con el mouse sobre él, se despliegan todas las opciones que contiene. A su vez, es posible que alguno de ellos contenga un submenú dentro, que está señalizado por un triángulo negro y pequeño, a modo de flecha hacia la derecha.
+ </para>
+
+ <para>
+ <figure><title>El menú desplegable.</title>
+ <graphic fileref="img/figura5.png"/>
+ </figure>
+ </para>
+ </sect2>
+
+<sect2>
+ <title>Los botones de la barra inferior.</title>
+ <para>
+Al pie de los diferentes listados, se pueden encontrar una serie de botones especialmente creados para manejar la información de los mismos.
+ </para>
+
+ <para>
+Así pues el sistema permite: Crear un nuevo registro, Listar los registros, Guardar un registro creado, guardar y permitir a su vez agregar uno nuevo, borrar el registro; así como un acceso directo por ejemplo al módulo "Cuentas" (si se trata del listado de alumnos), entre otras funciones.
+ </para>
+ <para>
+ <figure><title>Botones de la barra inferior.</title>
+ <graphic fileref="img/figura6.png"/>
+ </figure>
+ </para>
+</sect2>
+
+<sect2>
+ <title>Las barras de acciones.</title>
+ <para>
+Son barras de botones, que funcionan como accesos a determinadas acciones a realizar sobre un elemento. El siguiente gráfico muestra algunos de los distintos tipos de barras que se presentan a lo largo del uso del ALBA, y la explicación de cada botón a modo de ejemplo. De todas formas, al pasar con el mouse sobre el ícono, se informa el nombre de la acción.
+ </para>
+
+ <para>
+ <figure><title>Barras de acciones.</title>
+ <graphic fileref="img/figura7.png"/>
+ </figure>
+ </para>
+ <para>
+Algunos ejemplos se indican en esta lista:
+
+1.Botón "Editar": permite ingresar a los datos cargados y modificarlos.
+2.Botón "Borrar": elimina el registro.
+3.Botón "Ir a cuenta": acceso directo a la cuenta relacionada con el alumno o con un responsable.
+4.Botón "Vacunas": acceso directo al listado de Vacunas por alumno.
+5.Botón "Asistencias": acceso directo al módulo de asistencia de alumnos.
+6.Botón "Legajo": acceso directo al legajo pedagógico el alumno.
+7.Botón "Boletín": acceso directo a la carga de notas en el boletín de los alumnos según división.
+8.Botón "Locación": acceso directo al listado de las locaciones de un establecimiento.
+ </para>
+
+</sect2>
+
+<sect2><title>Ventanas de filtros.</title>
+<para>
+Las ventanas de filtro, permiten hacer una búsqueda por uno o más criterios determinados. en un listado. El ejemplo muestra una búsqueda que puede realizarse por tres criterios distintos. El botón inferior borrar, elimina la búsqueda realizada y el filtrar la inicia.
+</para>
+
+<para>
+Diferentes módulos del ALBA utilizan este sistema para mejorar las búsquedas.
+</para>
+
+ <para>
+ <figure><title>Ventanas de filtros.</title>
+ <graphic fileref="img/figura8.png"/>
+ </figure>
+ </para>
+
+</sect2>
+
+<sect2><title>Los listados de los datos.</title>
+<para>
+Los listados generados por los datos ingresados, cuentan con los botones típicos de una barra inferior, y con una barra de acciones (generalmente de edición y otras acciones según sea el caso). Estos listados, pueden ser ordenados haciendo click en el título de la columna, de donde tomará el criterio de la forma de ordenamiento de datos (ascendente/descendente, o alfabético ascendente y descendente).
+</para>
+<para>
+Existen en algunos casos específicos (como el del listado de Provincias) un orden diferente establecido por defecto. Como en el caso nombrado, se cuenta con el campo "orden" que establece un "peso" del dato, para su ordenamiento posterior en los listados. A mayor número, mayor peso y por ende, más bajo aparecerá el dato.
+</para>
+<para>
+Los listados pueden contar con más de una página, y por ello cuentan con flechas para repaginar.
+</para>
+</sect2>
+
+<sect2><title>Los mensajes al grabar.</title>
+<para>
+Siempre que se realice una acción sobre los listados (como edición, borrado o ingreso de un registro nuevo); en la parte superior de éstos se indicará el resultado de la acción.
+</para>
+<para>
+Un criterio muy básico de colores, además del mensaje textual, informará si el resultado fue exitoso (color verde) o si se presentó alguna dificultad (color rojo). Los errores que pueden aparecer, casi siempre son relativos a la falta de información obligatoria para la carga del registro.
+</para>
+</sect2>
+
+</sect1>
+</chapter>
Added: prosistem/alba/trunk/alba/doc/manual/xml/capitulo_3.xml
===================================================================
--- prosistem/alba/trunk/alba/doc/manual/xml/capitulo_3.xml 2007-06-15 19:27:57 UTC (rev 4749)
+++ prosistem/alba/trunk/alba/doc/manual/xml/capitulo_3.xml 2007-06-15 20:40:55 UTC (rev 4750)
@@ -0,0 +1,85 @@
+<chapter><title>Diccionario de conceptos.</title>
+<para>
+La siguiente lista, presenta las definiciones de los conceptos utilizados para la elaboración de este sistema de gestión. Algunos de ellos, reflejan elementos utilizados en la vida cotidiana de las escuelas; otros, por el contrario, son útiles para establecer funcionalidades para otra clase de unidades educativas.
+</para>
+
+<sect1><title>Los conceptos. </title>
+<sect2><title>Cuentas.</title>
+<para>
+La <emphasis>cuenta</emphasis> es utilizada en ALBA como un elemento para organizar información de varios alumnos con un responsable común. Una cuenta funciona muchas veces como una familia particular, pero puede no ser exactamente una familia en sentido estricto. Una cuenta integra: un responsable de la misma y un grupo de alumnos relacionados. En un futuro, también integrará información contable de los pagos de las cuotas en el caso de escuelas o unidades educacionales privadas.
+</para>
+</sect2>
+
+
+<sect2><title>Espacios.</title>
+<para>
+Un espacio, es un lugar que pertenece a una locación de un establecimiento en particular. Ejemplo de un espacio es un aula, un laboratorio, un gimnasio, etc.
+</para>
+</sect2>
+
+<sect2><title>Establecimiento.</title>
+<para>
+Unidad donde se organiza la oferta educativa, y que cuenta con una autoridad máxima como responsable pedagógico administrativos. El establecimiento puede tener diferentes locaciones.
+</para>
+</sect2>
+
+<sect2><title>Grados/Años.</title>
+<para>
+Según el nivel escolar, los grados (primaria) o años (secundaria), se definen como un grupo de alumnos que se agrupan según edad y plan de estudios. Los grados o años pueden tener diferentes secciones/divisiones. (Un ejemplo de grado en primaria sería Primero. En el caso de secundarios: Primer año bachiller, ya que define el plan de estudios.)
+</para>
+</sect2>
+
+<sect2><title>Locación.</title>
+<para>
+La locación de un establecimiento, es el espacio físico donde se desarrolla la tarea educativa. Una locación puede categorizarse en sedes o anexos. (ALBA permite otras clasificaciones de locaciones en caso de ser necesario).
+</para>
+</sect2>
+
+<sect2><title>Módulo.</title>
+<para>
+Un módulo agrupa diferentes acciones sobre un determinado elemento. Por ejemplo, el módulo <emphasis>alumno</emphasis> (Ingresar alumno) permite realizar diferentes acciones sobre la información como editar, borrar, relacionar con cuentas, etc. Muchos módulos, se relacionan entre sí conformando una sección del menú desplegable (por ejemplo: Alumnos.)
+</para>
+</sect2>
+
+<sect2><title>Organización.</title>
+<para>
+Una organización, refiere a una persona jurídica que administra uno o más establecimientos. En ALBA, el módulo organización permite el ingreso de todos los datos administrativos de la misma, para las acciones futuras de cobro en caso de tratarse de establecimientos educativos privados.
+</para>
+</sect2>
+
+<sect2><title>Permiso.</title>
+<para>
+Un permiso permite acceder a determinado módulo del sistema. ALBA cuenta con un sistema de permisos para administrar la seguridad, donde un usuario puede tener asignados permisos para unos módulos y otros no (según lo gestione el administrador del sistema).
+</para>
+</sect2>
+
+<sect2><title>Responsables.</title>
+<para>
+Un responsable de cuenta, es aquel adulto que siendo o no familiar de los alumnos relacionados con la misma, lleva adelante la tarea de recibir información del establecimiento, actualizar la información de los alumnos de la cuenta, responder ante las consultas administrativas de la organización, etc.
+</para>
+<para>
+ALBA permite establecer la relación (parental o no) entre el responsable y los alumnos de la cuenta, así como establecer si cuentan con el permiso del retiro del menor del establecimiento.
+</para>
+</sect2>
+
+<sect2><title>Rol.</title>
+<para>
+Un rol es un grupo de permisos que se le da a una determinada persona según el papel y las responsabilidades que tome en el establecimiento. Por ejemplo, un rol puede ser el de <emphasis>Secretaria/o</emphasis>, al que se le puede asignar los permisos de edición de información alumnos, emisión de consultas y listados etc.
+</para>
+</sect2>
+
+<sect2><title>Sección/División.</title>
+<para>
+Una sección es un grupo escolar formado por alumnos que cursan o no el mismo grado o año, en el mismo espacio y con el mismo equipo de docentes. Por ejemplo, en una escuela primaria pueden existir las secciones <emphasis>A</emphasis> y <emphasis>B</emphasis>. En ALBA (como en la forma de expresión coloquial) se toma a la división como un <emphasis>grado/año + sección/división</emphasis>, siendo entonces un grupo de alumnos que comparten el docente, el espacio y el grado/año, pongamos por caso: <emphasis>Primer Grado A.</emphasis>
+</para>
+</sect2>
+
+<sect2><title>Usuarios.</title>
+<para>
+Se denomina usuario, a la identidad que con nombre y clave propia, cuenta con diferentes permisos (o roles si ya tiene uno definido) para realizar acciones en el sistema ALBA. En ALBA el administrador del sistema crea nuevos usuarios y define los diferentes accesos según sean las responsabilidades del mismo.
+</para>
+</sect2>
+
+</sect1>
+
+</chapter>
Modified: prosistem/alba/trunk/alba/doc/manual/xml/manual.xml
===================================================================
--- prosistem/alba/trunk/alba/doc/manual/xml/manual.xml 2007-06-15 19:27:57 UTC (rev 4749)
+++ prosistem/alba/trunk/alba/doc/manual/xml/manual.xml 2007-06-15 20:40:55 UTC (rev 4750)
@@ -4,6 +4,8 @@
<!ENTITY recomendaciones.xml SYSTEM "recomendaciones.xml">
<!ENTITY capitulo_1.xml SYSTEM "capitulo_1.xml">
<!ENTITY indice.xml SYSTEM "indice.xml">
+<!ENTITY capitulo_2.xml SYSTEM "capitulo_2.xml">
+<!ENTITY capitulo_3.xml SYSTEM "capitulo_3.xml">
]>
<book>
<title>ALBA - Manual de Usuario</title>
@@ -13,5 +15,7 @@
&presentacion.xml;
&recomendaciones.xml;
&capitulo_1.xml;
+ &capitulo_2.xml;
+ &capitulo_3.xml;
&indice.xml;
</book>
Modified: prosistem/alba/trunk/alba/doc/manual/xml/recomendaciones.xml
===================================================================
--- prosistem/alba/trunk/alba/doc/manual/xml/recomendaciones.xml 2007-06-15 19:27:57 UTC (rev 4749)
+++ prosistem/alba/trunk/alba/doc/manual/xml/recomendaciones.xml 2007-06-15 20:40:55 UTC (rev 4750)
@@ -0,0 +1,26 @@
+<chapter><title>Recomendaciones iniciales </title>
+<para> En este apartado se presentan algunas recomendaciones que pueden facilitar la lectura de este manual y la comprensión de la oferta de ALBA: </para>
+
+<para> Antes de comenzar, es importante acordar sobre las definiciones de algunos de los conceptos que se utilizan a lo largo del manual, y que pueden consultarse en el capítulo tres. </para>
+<para>
+Este documento se encuentra también disponible para descarga en: http://www.proyectoalba.com.ar/manual_alba_gestionescolar.pdf. Además de este manual, el propio sistema posee esta ayuda disponible también desde el menú para facilitar su uso.
+</para>
+<para>
+El manual cuenta con varios apartados que resumen y simplifican la información completa, para facilitar su lectura o consultas específicas. Es posible antes de completar la revisión completa de este documento, avanzar desde los capítulos 14 y 15 (Ejemplo práctico y Cómo realizar algunas tareas, respectivamente).
+</para>
+<para>
+ALBA, está desarrollado para contemplar la posibilidad de la gestión de varios establecimientos de una misma empresa (en el caso de tratarse de privados) que se denomina en esta aplicación "organización". De todas formas puede utilizarse en escuelas públicas sin mayores dificultades. A partir de hoy, se encuentra disponible para descarga la versión 1.0 beta de este sistema
+</para>
+<para>
+Los primeros módulos desarrollados y que se explican en este documento, son parte de un proyecto más ambicioso que contemple a medida que avanza, diferentes niveles de enseñanza. Si Ud. tiene algún tipo de institución educativa no contemplada, es posible contactarse para solicitar cambios a medida de las necesidades.
+</para>
+<para>
+Recuerde que al tratarse de Software Libre (licenciado con la Licencia Pública General GPL) el sistema se pone a disposición junto a su código fuente (instrucciones codificadas inteligibles para el hombre, aún no compiladas) lo que permite la modificación del mismo por parte de cualquier profesional en el lenguaje.
+</para>
+<para>
+El modelo del Software Libre siempre propone una interacción entre usuarios y desarrolladores, por lo que ante cualquier error o sugerencia es posible comunicarse con el equipo de desarrollo a contacto en proyectoalba.com.ar
+</para>
+<para>
+¡Disfrute de la lectura!
+</para>
+</chapter>
\ No newline at end of file
Más información sobre la lista de distribución Alba-desarrollo