MANUAL DO DIARIOVOX
===================

Verso 1.0
Autores: Fernando de Paula Zamboni e Gabriel Schuck
Em 2 de setembro de 2026


1. APRESENTAO
===============

O DiarioVox  um dirio pessoal falado para o DOSVOX. Ele permite adicionar,
listar, ler, editar e excluir entradas. Os textos so escritos no Edivox e as
entradas longas so lidas no Levox.

O programa protege o contedo com senha. Tambm  possvel cadastrar uma frase
secreta para criar uma senha nova caso a senha atual seja esquecida.

Ao iniciar, o programa anuncia o nome e a verso instalada. O arquivo
versao.wav, quando existe, fala somente a palavra "Verso"; o nmero 
sintetizado a partir da constante do programa.


2. ARQUIVOS PRINCIPAIS
======================

DiarioVox.exe: programa compilado.
dosvox.ini: contm a seo [diariovox] com os caminhos e preferncias.
diariovox.atu: instala as opes e cadastra o programa como utilitrio.
sons: pasta dos arquivos WAV gravados.
dados: pasta do cofre, da segurana e dos temporrios de trabalho.
LEIAME.txt: informaes tcnicas e de compilao.
sons.txt: roteiro com o nome e a mensagem de cada WAV.


3. INSTALAO
=============

Copie DiarioVox.exe para C:\winvox e coloque diariovox.atu no local usado pelo
atualizador do DOSVOX. O arquivo .atu acrescenta a seo [diariovox] e registra
o programa no menu de utilitrios, preservando as outras configuraes.

O cadastro fornecido usa Util16. Se esse nmero j estiver ocupado por outro
programa na instalao, escolha uma posio Util livre antes de aplicar a
atualizao. O identificador -UDiariovox acompanha o cadastro do utilitrio.

No primeiro incio, o programa tambm completa as chaves ausentes no dosvox.ini
localizado pela rotina oficial dosvoxIniDir e cria as pastas necessrias. Em
uma instalao comum, esse arquivo fica em %APPDATA%\dosvox\dosvox.ini.


4. CONFIGURAO DO DOSVOX.INI
=============================

Configurao padro:

[diariovox]
dirdiariovox=@\winvox\som\diariovox
caminhoeditor=@\winvox\edivox.exe
caminholeitor=@\winvox\levox.exe
pastadados=@\winvox\diariovox\dados
velocidadefala=0

caminhoeditor informa onde est o Edivox.
caminholeitor informa onde est o Levox.
pastadados informa onde ser guardado o cofre.
dirdiariovox informa onde sero procurados os WAVs.
velocidadefala define a velocidade inicial da fala do DiarioVox.

O arquivo  localizado por dosvoxIniDir. O DiarioVox usa sintAmbienteArq e
sintGravaAmbienteArq para ler e completar somente sua prpria seo, sem apagar
as outras sees do DOSVOX.

O smbolo @ representa a unidade onde o DOSVOX est instalado. Por exemplo, se
o DOSVOX porttil estiver na unidade D:, @\winvox\edivox.exe ser interpretado
como D:\winvox\edivox.exe. O programa expande esses caminhos antes de abrir o
editor, o leitor e as pastas de dados e sons.

Se Edivox e Levox estiverem disponveis no PATH do Windows, tambm  possvel
usar apenas:

caminhoeditor=edivox.exe
caminholeitor=levox.exe


5. PRIMEIRO USO
===============

Na primeira execuo, o DiarioVox solicita:

1. Uma senha;
2. A repetio da senha;
3. Uma frase secreta opcional.

A frase secreta deve ser longa, pessoal e difcil de adivinhar, mas precisa ser
lembrada. Ela no mostra a senha antiga. Sua funo  permitir o acesso  chave
do dirio e o cadastro de uma senha nova.

Se a frase for deixada vazia, no haver recuperao por frase.


6. DESBLOQUEIO
==============

Ao iniciar, digite a senha e pressione Enter. O texto da senha no  falado nem
mostrado na tela.

Depois de trs senhas incorretas, o programa oferece a recuperao pela frase
secreta. Confirmando com S, digite a frase e, se estiver correta, cadastre uma
senha nova.


7. MENU PRINCIPAL
=================

Use seta acima e seta abaixo para percorrer as opes. O item selecionado 
falado. Pressione Enter para execut-lo.

Atalhos disponveis:

A: adicionar entrada;
L: listar e ler entradas;
E: editar entrada;
X: excluir entrada;
F: finalizar o DiarioVox;
Escape: finalizar a partir do menu principal;
F1: ouvir a ajuda do menu.

As setas percorrem um item de cada vez. Page Up e Page Down saltam dez itens.
Home vai ao primeiro item e End vai ao ltimo. Ao tentar ultrapassar o incio
ou o fim, o programa emite um bipe e mantm a seleo na extremidade.


8. ADICIONAR UMA ENTRADA
========================

1. Escolha Adicionar ou pressione A;
2. Digite o ttulo e pressione Enter;
3. O Edivox ser aberto;
4. Escreva o texto normalmente;
5. Saia do Edivox com Control X;
6. Confirme a incluso com S ou cancele com N;
7. Digite a data desejada ou pressione Enter para usar a data atual.

Alm da data escolhida, o cofre registra automaticamente a data e a hora em que
a entrada foi criada.


9. LISTAR E LER ENTRADAS
========================

Escolha Listar e ler ou pressione L. Use as setas para percorrer as entradas.
Cada item anuncia o ttulo e a data.

Pressione L ou Enter para abrir a entrada selecionada no Levox. O arquivo
apresentado ao Levox contm:

- Ttulo;
- Data e hora de criao;
- Data e hora da ltima alterao, quando houver;
- Texto completo.

Ao fechar o Levox, o DiarioVox sobrescreve e apaga o temporrio e retorna ao
incio do menu. Em seguida, pergunta "Qual sua opo?" e seleciona Adicionar
entrada. Se o Levox no puder ser aberto, o texto  enviado ao sintetizador
como alternativa.

Pressione Escape para cancelar a listagem ou F1 para ouvir sua ajuda. Page Up
e Page Down saltam dez entradas; Home e End vo s extremidades. Quando uma
tecla tenta ultrapassar o comeo ou o fim, o programa emite um bipe e repete o
ttulo e a data da entrada que continua selecionada. Isso tambm ocorre quando
existe somente uma entrada.

Seta  direita soletra o ttulo selecionado usando sintSoletra, a mesma rotina
empregada pela unit dvArq do DOSVOX. Seta  esquerda repete somente o ttulo,
sem a data.


10. EDITAR UMA ENTRADA
======================

1. Escolha Editar ou pressione E;
2. Use as setas para localizar a entrada;
3. Pressione E ou Enter;
4. Digite um ttulo novo ou pressione Enter para conservar o atual;
5. Escolha se deseja alterar a data;
6. Edite o texto no Edivox e saia com Control X;
7. Confirme com S ou cancele com N.

Ao confirmar, o programa registra a data e a hora da alterao. Ao cancelar, o
ttulo e a data anteriores so restaurados.


11. EXCLUIR UMA ENTRADA
=======================

1. Escolha Excluir ou pressione X;
2. Use as setas para localizar a entrada;
3. Pressione X ou Enter;
4. Confirme a excluso definitiva com S ou responda N para cancelar.

Uma entrada excluda no possui lixeira interna. Mantenha cpias de segurana.


12. AJUDA COM F1
================

F1 apresenta a ajuda adequada ao lugar atual. No menu principal, explica
setas, Enter e letras de atalho. Na seleo de entradas, explica como escolher,
abrir, editar ou excluir e como cancelar com Escape.


13. MENSAGENS E ARQUIVOS WAV
============================

Toda informao til exibida na tela passa pela rotina Falar. Essa rotina:

1. Escreve a mensagem na tela;
2. Procura o WAV correspondente;
3. Reproduz o WAV quando ele existe;
4. Usa sintetiza quando o WAV no existe.

Portanto, o programa continua falado mesmo com a pasta sons vazia. Consulte
sons.txt para saber o nome e o texto recomendado de cada gravao.


14. DADOS, COFRE E SEGURANA
============================

Os ttulos, datas e textos ficam dentro do arquivo diario.cofre. O arquivo
seguranca.ini contm sais e pacotes protegidos da chave; ele no contm a senha
nem a frase secreta em texto aberto.

Durante a edio e a leitura,  necessrio criar temporariamente um TXT aberto
para Edivox ou Levox. Quando o programa recupera o controle, tenta sobrescrever
e apagar esse arquivo.

A proteo foi criada para compatibilidade com Delphi 6 e usa SHA-256,
aleatoriedade do Windows, derivao iterada e verificao de integridade. Ela
no usa o mesmo formato AES-GCM do complemento do NVDA e ainda deve ser
auditada antes de guardar informaes de risco elevado.


15. CPIAS DE SEGURANA
=======================

Feche o DiarioVox antes de copiar a pasta dados. Guarde juntos, no mnimo:

- diario.cofre;
- seguranca.ini.

No adianta copiar somente um deles. Sem a senha ou a frase secreta correta,
no existe uma senha administrativa nem um mecanismo oculto de recuperao.


16. SOLUO DE PROBLEMAS
========================

O Edivox no abre:
Confira caminhoeditor na seo [diariovox] do dosvox.ini. Teste
C:\winvox\edivox.exe ou edivox.exe quando ele estiver no PATH.

O Levox no abre:
Confira caminholeitor na seo [diariovox] do dosvox.ini. Teste
C:\winvox\levox.exe ou levox.exe quando ele estiver no PATH.

Uma mensagem no possui gravao:
Isso no impede o uso. O DiarioVox deve envi-la automaticamente para
sintetiza. Confira sons.txt antes de gravar um WAV novo.

As setas ou F1 no respondem:
Confirme se o programa foi compilado com as unidades DVCRT e DVWIN compatveis
com sua instalao do DOSVOX. Informe o comportamento e a verso utilizada.

A senha demora para ser verificada:
A verso 1.0 ou posterior reutiliza o provedor criptogrfico nas vinte mil
repeties. Verses anteriores abriam o provedor repetidamente e eram mais
lentas.

O banco foi indicado como danificado:
No substitua os arquivos imediatamente. Faa uma cpia integral da pasta
dados e procure verificar se diario.cofre e seguranca.ini pertencem ao mesmo
conjunto.


17. ENCERRAMENTO
================

No menu principal, escolha Finalizar com as setas e Enter, pressione F ou use
Escape. O programa dir "Obrigado por usar o DiarioVox" antes de encerrar.
