Wiki

Qualicode — Producto

Se lee en 5 min

🎙️ Producto: Qualicode

Local first. Agente transparente. Humano al mando.

📁 Local first — cómo funciona

Qualicode no usa base de datos propietaria. Todo tu proyecto es una carpeta de archivos TXT:

mi-proyecto/
├── proyecto.json              ← metadatos del proyecto
├── raw/                       ← audios originales
│   ├── entrevista-01.mp3
│   └── entrevista-02.mp3
├── transcripciones/           ← transcripciones en TXT
│   ├── entrevista-01.txt
│   └── entrevista-02.txt
├── codigos/                   ← códigos propuestos por el agente (y validados)
│   ├── codigos-propuestos.txt ← lo que sugiere el agente (pendiente de revisión)
│   ├── codigos-aprobados.txt  ← lo que el humano ha aceptado
│   └── libro-de-codigos.txt   ← codebook completo
├── temas/
│   ├── temas-propuestos.txt
│   └── temas-aprobados.txt
├── informes/
│   ├── informe-borrador.md    ← generado por el agente
│   └── informe-final.md       ← editado/aprobado por el humano
└── log/
    └── cambios.txt            ← registro de todo (humano y agente)

💡 Si Qualicode desapareciera mañana, tienes todas tus transcripciones, códigos e informes en TXT. Abres cualquier archivo con Notepad, VS Code, o cat y está todo ahí.

🤖 Cómo funciona el agente

Principio: el agente no tiene poderes especiales

Todo lo que el agente puede hacer, el humano puede hacerlo exactamente igual:

Acción del agenteCómo lo haría el humano
Propone un código en codigos-propuestos.txtAbre el TXT y escribe el código a mano
Agrupa fragmentos bajo un tema en temas-propuestos.txtLee las transcripciones y escribe los temas manualmente
Genera un borrador de informe en informes-borrador.mdAbre el TXT y redacta el informe él mismo
Extrae entidades (nombres, fechas, lugares)Busca en el TXT con Ctrl+F y las anota

El agente no altera archivos sin permiso. Escribe en *-propuestos.txt o *-borrador.md — archivos que el humano debe revisar y aprobar explícitamente.

Flujo de trabajo con el agente

1. Humano: "Analiza la entrevista-01 y propón códigos"
   └→ Agente escribe en codigos-propuestos.txt

2. Humano: Abre codigos-propuestos.txt, lee las propuestas
   └→ Decide: acepta algunas, rechaza otras, modifica otras

3. Humano arrastra códigos aceptados a codigos-aprobados.txt
   └→ O bien, un botón "Aceptar seleccionados" en la UI

4. Humano: "Genera un informe borrador con los códigos aprobados"
   └→ Agente escribe informe-borrador.md

5. Humano edita informe-borrador → informe-final.md
   └→ Listo. Datos en TXT. Control humano.

🔧 Funcionalidades principales

1. Transcripción automática

  • Subida de audio/video (MP3, WAV, MP4, M4A) → se guarda en raw/
  • Transcripción con Whisper optimizada para español (incluye acentos latinoamericanos)
  • Detección de hablantes (diarización)
  • Editor de transcripción con línea de tiempo
  • Resultado: archivo TXT en transcripciones/ — editable con cualquier herramienta
  • Grabación en vivo desde navegador

2. Agentes de IA (transparentes)

AgenteArchivo que escribeHumano puede hacerlo
Codificación abierta → propone códigos emergentescodigos-propuestos.txt✅ Lee el TXT y escribe códigos a mano
Codificación temática → agrupa en categoríastemas-propuestos.txt✅ Mueve códigos entre categorías manualmente
Sentimiento → clasifica tono emocionalcodigos-propuestos.txt (con etiqueta de sentimiento)✅ Lee y etiqueta manualmente
Entidades → extrae nombres, lugares, términoscodigos-propuestos.txt✅ Busca y anota en el TXT
Informes → genera borrador ejecutivoinformes-borrador.md✅ Escribe el informe él mismo desde cero

3. Gestión de códigos

  • Archivos TXT: libro de códigos, código-propuestos, código-aprobados
  • Árbol jerárquico de códigos en la UI (lee/escribe los TXT)
  • Codificación manual: seleccionas texto en la transcripción y asignas código
  • Búsqueda por código en todos los documentos
  • Matriz de códigos por documento

4. Informes

  • Borrador automático: el agente escribe informe-borrador.md
  • Informe final: el humano edita, completa y renombra a informe-final.md
  • Exportación a PDF, DOCX, HTML (cogiendo los TXT como fuente)
  • Dashboard interactivo (solo visualización — los datos siguen siendo los TXT)

5. Colaboración

  • Misma carpeta compartida (Git, Dropbox, Syncthing — lo que el equipo quiera usar)
  • Cada persona edita sus TXT y los cambios se sincronizan
  • log/cambios.txt registra quién hizo qué
  • Sin lock-in: si quieres cambiar de herramienta, te llevas los TXT

🧪 Arquitectura

                    ┌─────────────────────────────────────────┐
                    │           CARPETA DEL PROYECTO           │
                    │     (Todo son archivos TXT/JSON/MD)      │
                    │                                          │
                    │  raw/  transcripciones/  codigos/       │
                    │  temas/  informes/  log/                 │
                    └──────────────────┬──────────────────────┘
                                       │
          ┌────────────────────────────┼────────────────────────────┐
          │                            │                            │
          ▼                            ▼                            ▼
┌──────────────────┐       ┌──────────────────┐       ┌──────────────────┐
│   Interfaz UI    │       │    Agente IA      │       │  Terminal /      │
│  (editor visual) │ ◄────►│  (lee/escribe     │       │  VS Code /       │
│                  │       │   los mismos TXT) │       │  cualquier       │
│  Editas códigos  │       │                  │       │  editor de TXT   │
│  con drag & drop │       │  Solo propone ── │       │                  │
│  o directamente  │       │  nunca escribe   │       │  El humano       │
│  en el TXT       │       │  sin aprobación  │       │  puede editarlo  │
└──────────────────┘       └──────────────────┘       └──────────────────┘
         │                                                    │
         └──────────────────────┬────────────────────────────┘
                                ▼
               ┌──────────────────────────────────┐
               │      HUMANO DECIDE                │
               │  acepta código? → pasa a aprobados │
               │  rechaza? → se queda en propuestos │
               │  modifica? → edita el TXT          │
               │  publica informe? → final.md       │
               └──────────────────────────────────┘

🚧 Hoja de ruta

FaseQuéMVP
Fase 0Transcripción Whisper → TXT + editor básico✅
Fase 1Agente propone códigos en codigos-propuestos.txt + UI para aceptar/rechazar✅
Fase 2Agente temático + temas-propuestos.txt
Fase 3Informes: agente escribe informe-borrador.md → humano finaliza
Fase 4Colaboración multi-usuario sobre la misma carpeta de TXT
Fase 5API para integración con otras herramientas (los TXT son el interfaz)

📝 Ejemplo concreto

Entrevista con un paciente → transcripciones/entrevista-paciente-01.txt

— Doctor, desde que empecé el tratamiento he notado que...
— Cuénteme más sobre eso...
— Sí, al principio tenía dudas, pero luego vi que...
 
[El humano selecciona el texto y pide al agente:]
"Propón códigos para este fragmento"

Agente escribe en codigos-propuestos.txt:

## Fragmento: línea 12-18, entrevista-paciente-01.txt
Códigos propuestos:
- adherencia-al-tratamiento (confianza: media)
- dudas-iniciales (sentimiento: negativo → positivo)
- relacion-medico-paciente (sentimiento: positivo)

Humano revisa y decide:

  • ✅ Adherencia al tratamiento → aceptado
  • ✅ Dudas iniciales → aceptado (pero cambia sentimiento a “neutro→positivo”)
  • ❌ Relación médico-paciente → rechazado (muy genérico, no aplica aquí)

Resultado final: codigos-aprobados.txt con los códigos que el humano decidió mantener.

Vista Gráfica