El plan del sitio

PLAN.md se escribe en el momento en que termina la primera compilación del proyecto y está pensado para describir siempre el sitio tal como está ahora, no un registro de todo lo que le ha pasado (para eso están la pestaña Versiones y el Registro de cambios). La pantalla Plan del sitio convierte ese Markdown en una interfaz real: una tabla para las páginas, una lista para los módulos, una lista de verificación para las preguntas abiertas y texto normal para los datos del negocio, la marca y las decisiones.

Antes de que termine cualquier compilación, no hay nada que leer todavía: la pantalla muestra «Aún no hay plan», explica con claridad que el plan lo escribe la primera compilación del proyecto y enlaza de vuelta a la página del proyecto, en lugar de mostrar una tabla vacía.

Un sitio cuyos archivos llegaron sin plan (publicado desde otra herramienta de IA mediante el conector, importado o subido) también recibe uno: la pantalla empieza el plan a partir del brief del proyecto, las opciones del kit y las páginas medidas, y un aviso, Este plan se creó para ti, ofrece «Guardar este plan», que lo convierte en el plan real del proyecto para que cada sección se pueda editar. «Leer el plan completo del sitio» lleva al documento del plan en la pestaña Plan y brief.

Las herramientas añadidas después desde el Kit (Añadir al plan) se unen a la lista de Módulos como Planificado, con un enlace Ver en el Kit, incluso cuando el texto del plan se escribió antes de que se añadieran.

Bajo el título, una línea indica cuándo se actualizó por última vez el plan: «Plan actualizado 2 oct, 15:04». Esa hora procede de la última vez que aiKit midió los archivos reales del sitio, lo que ocurre después de cada cambio (una edición en el chat, un anclaje, una adición desde el Kit, una restauración, una edición manual del plan o una publicación desde otra herramienta de IA).

Arriba, una vez que existe un plan: una barra de porcentaje completado y tres tarjetas debajo: Páginas creadas (de las páginas planeadas), Módulos creados (de los módulos elegidos) y Preguntas respondidas (de las preguntas abiertas del plan). Cada tarjeta es un botón que desplaza la pantalla hasta la sección que cuenta. Nada de esto lo indica el propio texto del plan: una página cuenta como creada solo cuando aiKit la encuentra en los archivos reales del sitio; un módulo cuenta como creado solo según el informe de creación verificado o el módulo encontrado en los archivos; y una pregunta cuenta como respondida cuando su línea está marcada en el plan o el cliente la respondió en su página de Preguntas.

Hay dos cosas que hacen que el plan se atrase, y la pantalla indica cuál: la revisión con IA que reescribe el plan después de un cambio no terminó («El plan escrito no se actualizó después del último cambio», con el motivo), o el sitio tiene una versión más reciente que la que se usó para medir el plan («El sitio cambió después de la última actualización de este plan»). En cualquiera de los dos casos aparece un botón «Actualizar plan». La página nunca lo ejecuta por su cuenta al abrirla (abrir una página nunca usa IA); el motor ya incorpora cada cambio al plan en segundo plano, y el botón está para cuando eso se atrasó. Actualizar plan incorpora el cambio más reciente al plan escrito y vuelve a medir el sitio. Si aún no se completa, el aviso se mantiene con lo que salió mal, y puedes volver a pulsar Actualizar plan o editar el plan a mano.

La tarjeta de Salud califica el sitio sobre 100 según reglas que aiKit revisa en los archivos reales, nunca según la opinión de la IA: un título de página o una descripción para buscadores que falta o está repetido, una página sin encabezado principal o con más de uno, un enlace a una página que no existe, una página a la que nadie enlaza y que el menú omite, imágenes sin descripción para lectores de pantalla, páginas muy cortas, un formulario sin destino y un módulo que el resumen pidió y que no está en el sitio. Cada problema indica en qué página está, por qué importa, y tiene un botón Corregir: Corregir envía la instrucción lista del problema como solicitud y se la entrega a la IA; el botón muestra «Corrección solicitada» mientras trabaja, y la puntuación se vuelve a medir cuando el cambio se aplica. Filtra la lista por gravedad con los contadores Alta, Media y Baja, y «Mostrar todo» quita el filtro.

El Mapa del sitio muestra el sitio como un árbol: inicio arriba, luego el menú en orden, y después las páginas a las que se llega desde esas páginas. Las páginas a las que nadie enlaza aparecen en su propio grupo; las páginas que el plan lista pero que aún no están creadas se dibujan con línea punteada y se marcan como Planeada; y las páginas creadas que el plan no menciona se marcan como «No está en el plan», con un botón «Añadir al plan» que las agrega a la sección Páginas.

Pulsa cualquier página (en el mapa del sitio o en la lista de Páginas) para abrir sus detalles junto al plan. La barra de direcciones cambia a ?page=/about, así el enlace abre la misma página para cualquier persona del equipo. Los detalles muestran cómo se ve la página en Google (título, dirección, descripción), sus secciones y encabezados principales, número de palabras, imágenes y cuántas no tienen descripción, sus formularios y qué módulo del kit los procesa, si el cliente la aprobó, y el último cambio: cuándo, quién lo pidió y qué se pidió.

El Historial enumera las versiones que aiKit guarda (la Original y las 10 más recientes), de la más nueva a la más antigua: su número, qué tipo de cambio fue (Primera creación, Chat, Fijar, Kit, Publicado, Restaurar, Edición del plan), cuándo, qué se pidió, quién lo pidió y qué páginas cambiaron (pulsa una página para abrir sus detalles). La más nueva aparece marcada como Versión actual; cualquier versión anterior tiene «Restaurar esta versión», que pide confirmación y guarda el estado actual antes de devolver el sitio a esa versión, así que una restauración se puede deshacer. Se muestran las tres primeras; «Mostrar todo» enumera el resto.

La sección Datos del negocio compara el teléfono, correo electrónico, dirección y horario del Archivo del cliente con el texto de las páginas creadas (primero inicio y contacto). Cada dato muestra «En el sitio» o «No encontrado en el sitio» (con cuántas páginas se revisaron, ya que el sitio puede mostrar un valor antiguo), y un enlace «Editar en el Archivo del cliente» mantiene el Archivo del cliente como la fuente oficial.

• Páginas: una tabla con Página, Ruta, Propósito y Estado (Creada o Planeada), con un enlace «Ver» real a la página en vivo una vez que está creada y el sitio está publicado.
• Módulos y herramientas: cada módulo que lista el plan, cada uno con una etiqueta Creado o Planeado y su propia nota.
• Datos del negocio: horario, dirección, servicios, precios y cualquier dato factual sobre el negocio, escrito como texto sencillo.
• Marca: la paleta, el tono y cualquier nota de estilo que haya registrado el plan.
• Decisiones: decisiones reales que ya se tomaron y que la siguiente edición no debe volver a discutir.
• Preguntas abiertas: una lista de verificación de cosas que aún no se han decidido de verdad, cada una con la indicación de respondida o pendiente.

Cada tarjeta de sección tiene los mismos dos botones. «Editar» abre el Markdown original de esa sección en un cuadro de texto sencillo y lo guarda directamente en PLAN.md; es una escritura real e inmediata (a través del endpoint PUT del propio proyecto), pero deliberadamente no inicia una creación ni una publicación; solo cambia lo que dice el documento del plan, igual que editar cualquier otra nota.

"Solicitar un cambio" es diferente a propósito: abre un formulario breve ("¿Qué te gustaría cambiar en <section>?"), y al enviarlo se crea una solicitud real en la pestaña Feedback del proyecto, con la etiqueta "Plan del sitio — <Section>: …", exactamente igual que cualquier comentario o solicitud de Edición rápida, con su propio estado de seguimiento y un enlace "Ver la solicitud" una vez enviada. Usa Editar cuando quieras corregir o reescribir tú mismo el texto del plan; usa Solicitar un cambio cuando quieras que el sitio real (y, a su vez, el plan) se actualice para que coincidan.

El plan tiene dos capas. Las mediciones (páginas, títulos, secciones, enlaces, formularios, módulos, estado) las toma el código de los archivos reales después de cada cambio, así que nunca quedan desfasadas. El plan escrito (objetivos, datos del negocio, marca, decisiones, preguntas abiertas) lo mantiene al día una pasada de IA que se ejecuta tras cada cambio y reescribe solo las partes que el cambio tocó. Nunca agrega un registro de cambios ni entradas con fecha; el Historial es donde vive el registro de cambios.

Si esa pasada de IA falla, el plan escrito se deja tal como estaba en lugar de quedar a medio reescribir, el fallo se registra y la pantalla muestra Actualizar plan (ver arriba) en lugar de mostrar en silencio un plan desactualizado.

Una barra lateral junto al plan reúne las acciones (en el teléfono, la barra se convierte en un botón de ancho completo "Copiar el enlace para el cliente" justo debajo de la banda de progreso, y el resto se oculta bajo "Más acciones (3)"). "Compartir con el cliente" copia un enlace de solo lectura (aikit.ai/p/<project>/plan): sin herramientas del equipo, sin botones de edición, nada interno. "Abrir el sitio en vivo" es un enlace directo al sitio en vivo, o la barra indica claramente "Aún no está en vivo" si no lo está. "Archivos" muestra el número real de archivos con una lista desplegable de la ruta y el tamaño de cada archivo. "Descargar el plan" descarga el PLAN.md actual como un archivo .md real, exactamente igual a lo que muestra la pantalla, no un resumen regenerado.

La página del cliente se abre en su pestaña Plan: el mismo documento de plan del sitio que ve el equipo en la pestaña Plan y resumen (visión general y objetivos, público, estrategia, mapa del sitio, cada herramienta con lo que hace por su negocio y su estado, plan de contenido, cronograma, decisiones y preguntas abiertas), sin las partes solo para el equipo: nada de notas escritas al agregar una herramienta, ni nombres de quién agregó qué, ni enlaces al Kit de aiKit, ni el botón Escribir el plan. Una segunda pestaña, Páginas y aprobaciones, conserva la vista página por página de más abajo.

En Páginas y aprobaciones, protegido con el mismo código de acceso que ya usan para dejar comentarios (sin inicio de sesión aparte), el cliente ve la misma banda de progreso, un Mapa del sitio de sus páginas, la lista de Páginas con los enlaces "Ver", los módulos, los datos del negocio, la marca, las decisiones y las preguntas abiertas, además de una línea "Plan actualizado". No obtienen Estado, instrucciones de corrección, Historial, quién pidió qué, la lista de archivos, ni ningún botón de Editar o Pedir un cambio.

Todo lo que el equipo marca para uso interno se elimina en el servidor antes de enviar la página, en todas las secciones: una línea que contenga "(internal)", "[internal]" o "(staff only)", una línea que empiece con "Internal:" o "Staff only:", cualquier sección cuyo encabezado diga Internal o Staff only, y los comentarios ocultos. Esas líneas nunca llegan al navegador del cliente, ni siquiera en los datos de red de la página.

Cada página construida tiene un botón Aprobar. El cliente escribe su nombre (y una nota opcional) y aprueba; la aprobación está ligada al contenido exacto de esa página, así que si la página cambia después, muestra "Cambió desde que aprobó" y vuelve a pedir la aprobación. Solo quien use el código de acceso del cliente puede aprobar. Si abre el enlace del cliente con sesión iniciada como miembro del equipo, ve el estado de aprobación de cada página pero no el botón Aprobar, para que nadie pueda aprobar en nombre del cliente. En el Plan del sitio del equipo, las páginas aprobadas muestran "Aprobado por el cliente" y las modificadas "Cambiado desde la aprobación".

Un botón "Enviar comentarios" aparece al final: si el sitio está en vivo, abre el sitio real con la superposición de comentarios ya activada (usando su propio código de acceso); si aún no está en vivo, muestra en su lugar la página de Actualizaciones recientes.