# Notatky · Beta execution plan / Plan de ejecución

## English

Status: protected adult preview; external teen enrollment remains closed. Evidence checked September 5, 2026 (Pacific time). This continues BETA-READINESS.md and the existing A–G delivery order. Operating budget: at most $100/month total. First proposed family cohort: 5–10 invited families, learners 14–17, English and Spanish. This is a plan, not enrollment evidence or a legal compliance certificate.

### What is available now

- [Open the hosted preview](https://notatky-preview-production.up.railway.app/concept.html?style=deepblue). Railway successfully deployed merged PR20, including the revised sidebar and earlier flashcard/feedback/source-comparison features. Preview access remains protected.
- [My account](account.html): public Supabase configuration and existing-account email-code login are connected. Account editing supports explicit load, server admission checks, revision-aware save and draft export. Real second-device save/recovery has not yet been demonstrated.
- Supabase migrations 001–004 are installed in the separate Notatky project. Private adult admission has a maximum 14-day term and no browser self-enrollment. Installation created no adult grants. A verified email alone does not authorize library writes.
- [Flashcards](flashcards.html): manual cards, reveal/review and JSON export/import. Cards remain in this browser; cloud card synchronization and AI card generation are not connected.
- [Beta feedback](account.html#feedback): signed-in users can send to the private review queue. An operator reviews this queue in Supabase; there is no automatic email or parent alert. End-to-end production submission remains to be checked.
- [Writing coach](writing.html) and [source comparison](similarity.html) have interfaces. Hosted AI processing is unavailable. Source comparison checks exact passages against pasted text only; it does not scan the internet or certify originality.
- Hosted PDF/PNG/audio processing, cloud tutor responses and parent alerts remain unavailable. Local Mac processing is a separate environment.

### Ordered delivery checklist

| Stage | Acceptance evidence still required | Current state |
|---|---|---|
| A. Account foundation | Real login/logout/expiry on intended devices | Configuration and email templates installed; synthetic account tests pass; owner email verified |
| B. Family admission | Verified guardian relationship, learner assent, versioned agreements, revocation and safe-recipient handling | Family schema installed; operational verification and family onboarding remain open |
| C. Library integration | Real authenticated save, second-device restore, cross-user denial, conflict recovery and deletion | Editor and owner policies implemented; migrations installed; adult eligibility/grant and production acceptance pending |
| D. Protected processing | Authenticated PDF/PNG/voice jobs, isolated workers, resource limits, cancellation and EN/ES fixtures | Local/portable foundations exist; hosted integration open |
| E. AI and safeguarding | Reviewed vendor terms, enforced quotas, EN/ES safety evaluation, delivery failures and human escalation | Hosted AI and parent delivery not connected; provider/operations review pending |
| F. Launch operations | Recovery/deletion drill, support ownership, legal fields, vendor inventory, incident handling and intended domain | HTTPS protected Railway preview live; notatky.com connection and remaining operational checks open |
| G. Family acceptance | Full phone/tablet/desktop flow: upload/record → notes → additions → explanation → practice → restore | Pending completion of B–F; use synthetic material before teen data |

### Next small chunks

- [x] Merge PR20 and deploy the consistent sidebar (Railway deployment 390c473f-c1f3-4ccc-ad4f-8f684d529e11: SUCCESS).
- [x] Install migration 004 and inspect production catalog: RLS/FORCE RLS enabled, browser access denied, existing restrictive policies retained, zero adult admissions at installation.
- [ ] Confirm adult eligibility, record a genuine time-limited grant, then test a real note across two independently signed-in devices. Do not invent a guardian pair.
- [ ] Merge and verify PR21 feedback-draft protection; then test a real feedback receipt and operator queue handling.
- [ ] Connect bounded hosted document processing before enabling AI explanations; evaluate each separately.
- [ ] Bring flashcards into the explicitly saved account library through a separately reviewed schema/data-format change. Never silently upload local cards.
- [ ] Verify real iPhone/iPad/Android flows; emulated widths alone are not device acceptance.
- [ ] Complete legal and family safeguards, then obtain owner release approval before invitations.

### Required inputs and unresolved limits

The operator must provide legal name, mailing address, working privacy/support contacts and launch states. Guardian verification method, safety reviewer, retention schedule and vendor data-use terms must be finalized against the actual deployment. The bilingual [agreement pack](AGREEMENTS.html) remains a draft and must not collect acceptance while required fields are unresolved.

The adult pilot is a restricted test route, not proof of age or legal compliance. No automatic parental disclosure of every sensitive school question. No paid subscriptions or cancellation provider are connected; do not show a fake cancellation success. Full plagiarism scanning needs a separately evaluated provider and data-handling terms.

Each code chunk uses a separate branch/PR and relevant tests. Merge, deployment, database installation and real user acceptance are separate evidence stages. Roll back code using the previous verified release; revoke admissions to stop writes while preserving owner read/export/delete. Do not delete notes as an authorization rollback.

## Español

Estado: vista previa adulta protegida; la admisión externa de adolescentes sigue cerrada. Evidencia revisada el 5 de septiembre de 2026 (hora del Pacífico). Continúa BETA-READINESS.md y el orden A–G existente. Presupuesto operativo total: hasta $100/mes. Primer grupo propuesto: 5–10 familias invitadas, estudiantes de 14–17 años, inglés y español. No demuestra admisión ni certifica cumplimiento legal.

### Qué está disponible

- [Abrir la vista previa](https://notatky-preview-production.up.railway.app/concept.html?style=deepblue). Railway desplegó PR20 integrada, con el menú corregido y las funciones anteriores de tarjetas, comentarios y comparación. El acceso sigue protegido.
- [Mi cuenta](account.html): configuración pública de Supabase y acceso por código conectados. El editor permite carga explícita, comprobación de admisión, guardado con revisión y descarga del borrador. Falta demostrar guardado y recuperación reales entre dispositivos.
- Migraciones 001–004 instaladas en el proyecto separado de Notatky. La admisión adulta privada dura como máximo 14 días y no admite autoinscripción desde el navegador. La instalación no concedió permisos a ninguna cuenta. Verificar el email no autoriza escrituras.
- [Tarjetas](flashcards.html): creación manual, repaso e importación/exportación JSON. Solo se guardan en este navegador; sin sincronización de tarjetas ni generación con IA.
- [Comentarios](account.html#feedback): envío autenticado a la cola privada, revisada por un operador en Supabase. Sin correo automático ni alerta parental. Falta comprobar el envío completo en producción.
- [Tutor de escritura](writing.html) y [comparación de fuentes](similarity.html) tienen interfaces. La IA alojada no está conectada. La comparación solo examina pasajes exactos del texto pegado; no busca en internet ni certifica originalidad.
- Procesamiento alojado de PDF/PNG/audio, respuestas del tutor en la nube y alertas parentales todavía no disponibles. El procesamiento local del Mac es un entorno distinto.

### Lista de ejecución

| Etapa | Evidencia pendiente | Estado |
|---|---|---|
| A. Cuenta | Acceso, salida y expiración reales en dispositivos previstos | Configuración y plantillas instaladas; pruebas sintéticas aprobadas; email del propietario verificado |
| B. Admisión familiar | Relación verificada, asentimiento del estudiante, acuerdos versionados, revocación y destinatario seguro | Esquema instalado; verificación operativa e incorporación pendientes |
| C. Biblioteca | Guardado real, recuperación entre dispositivos, aislamiento, conflictos y eliminación | Editor y políticas implementados; migraciones instaladas; elegibilidad/admisión adulta y aceptación pendientes |
| D. Procesamiento | Trabajos autenticados PDF/PNG/voz, aislamiento, límites, cancelación y pruebas EN/ES | Bases locales/portátiles; integración alojada pendiente |
| E. IA y seguridad | Contratos, cuotas, evaluación EN/ES, fallos de entrega y revisión humana | IA alojada y entrega parental sin conectar |
| F. Operación | Recuperación/eliminación, soporte, datos legales, proveedores, incidentes y dominio | Vista previa HTTPS activa; notatky.com y demás verificaciones pendientes |
| G. Aceptación familiar | Flujo completo en teléfono/tableta/ordenador: material → apuntes → aportaciones → explicación → práctica → recuperación | Completar B–F; material sintético antes de datos de menores |

### Próximos bloques pequeños

- [x] Integrar PR20 y desplegar el menú coherente (Railway 390c473f-c1f3-4ccc-ad4f-8f684d529e11: SUCCESS).
- [x] Instalar migración 004; verificar RLS/FORCE RLS, denegación al navegador, políticas conservadas y cero admisiones adultas en la instalación.
- [ ] Confirmar elegibilidad adulta y registrar permiso temporal real; probar una nota en dos dispositivos con sesiones independientes. No inventar una relación parental.
- [ ] Integrar y verificar PR21 de protección del borrador; comprobar recepción real y gestión de comentarios.
- [ ] Conectar procesamiento alojado limitado antes de habilitar explicaciones con IA; evaluar cada función por separado.
- [ ] Incorporar tarjetas a la biblioteca de cuenta mediante un cambio de formato/esquema revisado. Nunca subir tarjetas locales sin una acción explícita.
- [ ] Probar iPhone/iPad/Android reales; emular tamaños no basta.
- [ ] Completar garantías legales/familiares y obtener aprobación de lanzamiento antes de invitar familias.

### Datos y límites pendientes

El operador debe proporcionar nombre legal, dirección postal, contactos de privacidad/soporte y estados de lanzamiento. Faltan método de verificación parental, responsable de seguridad, conservación y contratos de proveedores acordes al despliegue. Los [acuerdos bilingües](AGREEMENTS.html) siguen siendo borradores; no recoger aceptación con campos obligatorios sin completar.

La prueba adulta no demuestra edad ni cumplimiento legal. No revelar automáticamente a padres toda pregunta escolar sensible. No hay suscripciones de pago ni proveedor de cancelación conectado; no mostrar cancelaciones ficticias. Un análisis completo de plagio requiere evaluar proveedor y tratamiento de datos.

Cada bloque tiene rama/PR y pruebas pertinentes. Integración, despliegue, migración y aceptación real son evidencias distintas. Revertir código con la versión verificada anterior; revocar admisión para detener escrituras conservando lectura/exportación/eliminación del propietario. No borrar notas para revertir autorización.