# Primeros pasos

Esta página lleva a una organización desde la cuenta vacía hasta su primera sesión con acta: crear la cuenta, elegir el nombre de la organización y el plan, y celebrar en diez minutos una sesión completa con convocatoria, pase de lista, votación y acta. Las páginas de conceptos enlazadas explican cada pieza con detalle.

## 1. Crear la cuenta

1. Abrir [/signup/](/signup/) y pulsar **Continuar con Google**. Ciserex no guarda contraseñas: la identidad la aporta Google a través de Amazon Cognito (flujo PKCE).
2. Al volver del inicio de sesión, la cuenta de plataforma queda creada con el nombre y el correo de Google. Ese correo es el propietario de todo lo que se cree a continuación.
3. Escribir el nombre de la organización y su identificador (*slug*). El slug usa letras minúsculas, dígitos y guiones bajos. Se convierte en la dirección pública `<slug>.ciserex.com` y en el identificador interno `app-ciserex-with-tenant-<slug>`. No se puede cambiar después.
4. Elegir el idioma (`es` o `en`) y la zona horaria. El idioma rige la interfaz, los mensajes del bot y las actas; la zona horaria rige el calendario.

> El slug forma parte de todos los identificadores de la organización. Elegir uno corto y estable: `congreso`, `consejo_2026`, `aula_3b`.

## 2. Elegir la edición

Las cuatro ediciones llevan el sistema completo. Ninguna apaga funciones ni limita el número de miembros del padrón: lo que cambia es dónde vive el sistema y con qué respaldo contractual.

| Edición | Dónde se ejecuta | Miembros | Funciones |
|---|---|---|---|
| Prueba | ciserex.com, treinta días, sin tarjeta | sin límite | todas |
| Alojado | ciserex.com, operado por Ciserex | sin límite | todas |
| Autoalojado | su cuenta de AWS o su red local | sin límite | todas |
| Congreso | despliegue dedicado, acordado por escrito | sin límite | todas |

Una organización nueva empieza en **Prueba**: treinta días con todo abierto, sin tarjeta y sin renovación automática. Al terminar se elige Alojado o Autoalojado; los registros creados durante la prueba se conservan íntegros, incluido el registro de actos.

Este sitio no publica tarifas. Las condiciones económicas de cada edición —incluidas las cuotas de medios y de horas de transcripción— se acuerdan por escrito con el equipo: escriba a <sales@ciserex.com>. Mientras la plataforma está en prelanzamiento, el proveedor de pagos es una simulación que devuelve `passed` en toda transacción; no se cobra nada.

Al confirmar la edición, Ciserex crea la organización (el *tenant*) con una plantilla por defecto, las dimensiones de análisis iniciales y la apariencia estándar. Véase [La organización](#/concepts-tenant).

## 3. Entrar en la aplicación

La aplicación está en **app.ciserex.com**. Es una sola pantalla con pestañas: **Calendario**, **Agenda**, **Nómina**, **Archivo** y **Configuración**. A la derecha se abre el cajón de **la secretaría**, el agente que responde preguntas y ejecuta tareas con los permisos del usuario que las pide.

El calendario es la puerta de entrada: desde él se crean, abren y consultan las sesiones. Las demás pestañas muestran el estado de la sesión seleccionada.

## 4. Primera sesión en diez minutos

### Minuto 0 a 2: crear la sesión

1. En **Calendario**, pulsar en el día y hora deseados y elegir **Nueva sesión**.
2. Poner nombre a la sesión y elegir una plantilla. Para una primera prueba, `board` (consejo) o `poll` (sondeo) son las más cortas. Las seis plantillas incorporadas se describen en [Plantillas de agenda](#/concepts-templates).
3. Guardar. La sesión queda en estado `PENDING` (programada) y sus puntos del orden del día se materializan a partir de la plantilla. Se pueden editar en la pestaña **Agenda**: título, detalle, tipo de decisión, opciones y mayoría exigida.

### Minuto 2 a 4: la nómina

En **Nómina** se decide quién puede ser llamado y quién puede votar.

- Modo **predefinido**: añadir a los miembros uno por uno o importar un CSV con nombre, correo, teléfono, grupo, asiento y peso. Cada miembro puede vincular su cuenta de Telegram siguiendo un enlace profundo `t.me/<bot>?start=<código firmado>` que la secretaría le envía por correo o que se le muestra en pantalla.
- Modo **ad hoc**: no hay lista previa. Al abrir el pase de lista aparece un código QR; quien lo escanea queda inscrito en la nómina de esa sesión.

Los campos, los modos y la verificación de identidad se explican en [La nómina](#/concepts-roster).

### Minuto 4 a 6: abrir la sesión y pasar lista

1. En **Calendario**, seleccionar la sesión y pulsar **Abrir**. La sesión pasa a la etapa `rollcall`.
2. Pulsar **Pasar lista**. Los miembros vinculados reciben en Telegram un botón de confirmación; los demás confirman desde la web. La lista se actualiza en tiempo real: presente, llamado sin respuesta, ausente, remoto.
3. Cuando la cifra de presentes alcanza el quórum exigido, la aplicación lo indica: "Consta la presencia de 84 de 128 miembros. Hay quórum." Pulsar **Iniciar sesión**. La sesión pasa a `ACTIVE`, etapa `session`.

### Minuto 6 a 8: una votación

1. En **Agenda**, abrir el primer punto de tipo `decision`. El punto pasa a `ACTIVE`.
2. Pulsar **Votar**. Se abre desde abajo la superposición de votación y el punto pasa a `PROCESSING`. Los miembros presentes ven las opciones en la web o como botones en Telegram.
3. La visualización se actualiza con cada papeleta: hemiciclo, cuadrícula, barras o gráfico divergente según el número de votantes y la plantilla. Las papeletas son inmutables; si un miembro cambia de opinión antes del cierre, la nueva papeleta sustituye a la anterior.
4. Pulsar **Cerrar votación**. Ciserex calcula el recuento, aplica la regla de mayoría y registra el resultado en el punto: `{ tally, passed, closed_at }`. El punto pasa a `ARCHIVED`.

Las reglas de mayoría y quórum, con ejemplos numéricos, están en [Mayorías y quórum](#/concepts-majorities-quorum). El funcionamiento de las papeletas, en [Papeletas](#/concepts-ballots).

### Minuto 8 a 10: cerrar y obtener el acta

1. Recorrer los demás puntos o retirarlos.
2. En **Calendario**, pulsar **Cerrar sesión**. La sesión pasa a `ARCHIVED`.
3. El cierre dispara la redacción del acta y los canales de distribución configurados. En **Archivo** aparece la sesión con su asistencia, sus resultados, su transcripción si hubo grabación, y el acta en Markdown y PDF.

El acta se redacta con verbos de registro: "Se aprueba el punto 3 por 71 votos a favor, 9 en contra y 4 abstenciones." Qué se conserva y qué se publica se describe en [El archivo](#/concepts-archive).

## 5. La secretaría

El cajón de la secretaría acepta preguntas y órdenes en lenguaje natural: "¿Quién falta por confirmar?", "Abre la votación del punto 2", "Resume la discusión del punto 4". La secretaría ejecuta las mismas operaciones que los botones de la interfaz, con los permisos del usuario que le habla, y nunca vota en nombre de nadie. Los miembros vinculados por Telegram pueden escribirle al bot con las mismas preguntas, limitadas a su organización.

## 6. Qué configurar después

- **Configuración → Apariencia**: logotipo y color de acento del sitio público.
- **Configuración → Nómina**: modo por defecto y método de verificación (`none`, `id`, `face`).
- **Configuración → Transcripción**: proveedor (Amazon Transcribe o OpenAI Whisper), idioma, número de hablantes. Véase [Transcripciones](#/concepts-transcripts).
- **Configuración → Análisis**: dimensiones sectoriales y transversales. Véase [Dimensiones de análisis](#/concepts-dimensions).
- **Configuración → Distribución**: canales que se ejecutan al cerrar una sesión. Véase [Canales de distribución](#/concepts-pipelines).

Para dudas, [/support/](/support/) o support@ciserex.com.

---

Siguiente: [La organización](#/concepts-tenant).
