ENCERRAMENTO DE MANIFESTOS

>>> O site distorce a formatação do texto
>>> Cole no BLOCO DE NOTAS que ficará melhor

PROJETO ENCERRAMENTO DE MANIFESTOS

Esta é a definição completa do APP que precisará ser desenvolvido. O processo é relativamente
simples, será mais fácil fazer do que explicar, por isso a definição ficou até grande.

O APP fará basicamente:
- Importar um arquivo texto com varias linhas (são notas fiscais)
- Permitir que o usuario escolha algumas dessas linhas (as notas que já entregou)
- Exportar lista escolhida pelo usuario para outro TXT (para nosso sistema dar baixa das entregas)

É exatamente isso, nada mais, o resto do texto é detalhamento. Mas já adianto tudo para
ganhar tempo com idas e vindas de programa errado.

-----------
IDEIA GERAL
-----------

Nosso motorista sai com vários manifestos (espécie de nota fiscal) no caminhão para
fazer entregas ao longo do dia. A finalidade do APP é permitir que o motorista importe
a lista dos manifestos que irá entregar e no final do dia mostre quais manifestos foram
entregues de fato.

No APP, haverá uma rotina para importação de um arquivo texto, uma tela para seleção de
linhas deste arquivo, e uma rotina para gravação das linhas selecionadas em outro arquivo
texto.

---------------------
TELA PRINCIPAL DO APP
---------------------

A tela principal do APP será formada por uma lista de opções na vertical:

??????????????????????????????????
? Importar lista de manifestos ?
? Encerrar manifestos ?
? Configurações ?
? Sair ?
??????????????????????????????????

---------------------
Opção "CONFIGURAÇÕES"
---------------------

Abrir uma tela onde serão cadastrados o CPF do motorista, a PLACA do caminhão e o
CAMINHO DE REDE onde estarão os arquivos de texto.

???????????????????????????????????????????????????????
? CPF do Motorista: [99999999999] ?
? Placa do caminhão: [XXXXXXX] ?
? Pasta de manifestos na rede: [//192.168.0.1/pasta] ?
? [SALVAR] [CANCELAR] ?
???????????????????????????????????????????????????????

- Todos os campos são obrigatórios.
- Campos de CPF e PLACA devem ficar sem formatação, apenas letras e números.
- Não precisa fazer crítica da validade do CPF ou da PLACA, basta exigir que
os campos sejam preenchidos.

------------------------------------
Opção "IMPORTAR LISTA DE MANIFESTOS"
------------------------------------

Rotina para importação da lista de manifestos:

01) Não precisa haver tela, apenas a execução dos comandos abaixo e uma mensagem no final.

02) Antes de qualquer coisa, o APP deve limpar os dados importados anteriormente porque
esta rotina pode ser executada várias vezes, mas não deve acumular os dados. Cada
importação começa do zero.

03) Verificar se o caminho de rede informado na tela de CONFIGURAÇÕES existe.

Isso servirá para confirmar se o celular está conectado na rede antes de fazer
qualquer coisa (o usuário deve fazer isso antes de abrir o APP). Se o caminho
não existir, dar mensagem de erro e retornar para tela principal.

????????????????????????????????????????????????????????????????????????
? Não localizei a pasta de manifestos na rede. ?
? > Verificar se a tela de CONFIGURAÇÕES está preenchida corretamente ?
? > Verificar se celular está conectado na rede da empresa ?
? [OK] ?
????????????????????????????????????????????????????????????????????????

04) Verificar se o arquivo "manifestos.txt" existe no caminho acima (nome fixo).
Se o arquivo não existir, dar mensagem de erro e retornar para tela principal.

????????????????????????????????????????????????????????????????????????
? Não localizei lista de manifestos na rede. ?
? > Verificar se a tela de CONFIGURAÇÕES está preenchida corretamente ?
? > Verificar se celular está conectado na rede da empresa ?
? > Solicitar geração da lista aos faturistas da empresa ?
? [OK] ?
????????????????????????????????????????????????????????????????????????

NOTA
----
Observe que desejo fazer os testes do caminho de rede e do arquivo separadamente.
A intenção é facilitar a resolução dos problemas.

05) Abrir arquivo texto e importar a lista de manifestos para o celular.

A lista poderá conter manifestos de vários motoristas e caminhões diferentes
(o mesmo arquivo servirá para todos os motoristas). Os dados serão separados
por ponto-e-vírgula e os campos serão estes (primeira linha será cabeçalho):

- CPF do motorista
- PLACA do caminhão
- Número do manifesto
- UF de destino do manifesto

Exemplo de arquivo texto:

CPF;PLACA;MANIFESTO;UF
**********;ABC1234;000111;SP
**********;ABC1234;000222;RJ
**********;CBA9X12;000333;SP
**********;CBA9X12;000444;RJ

Se a importação for realizada com sucesso, dar mensagem e voltar p/ tela principal.

???????????????????????????????????????????????
? Lista de manifestos importada com sucesso. ?
? [OK] ?
???????????????????????????????????????????????

Se houver algum erro além dos já mencionados (queda de rede, memória cheia, etc.)
favor colocar uma mensagem específica para facilitar a resolução de problemas.
Evitar mensagens genéricas que não ajudam em nada e já indicar possíveis soluções
na própria mensagem (igual estou fazendo com as minhas).

---------------------------
Opção "ENCERRAR MANIFESTOS"
---------------------------

Rotina para gravação da lista de manifestos entregues até o momento. Este processo é
conhecido pelos motoristas como "encerramento de manifesto", daí o nome da rotina.

01) Apresentar lista de manifestos e permitir que o usuário selecione alguns deles.
A lista completa deve ser filtrada pelo CPF e PLACA cadastrados na tela de
CONFIGURAÇÕES porque cada motorista só deve ver os seus próprio manifestos.

Se não houver dados (todos já foram entregues antes), dar mensagem abaixo e
retornar para a tela principal.

????????????????????????????????
? Não há manifestos pendentes. ?
? [OK] ?
????????????????????????????????

02) A lista apresentada deve conter apenas o número do manifesto e estado (UF):

??????????????????????????????????????????????????????
? Selecione os manifestos que devem ser encerrados: ?
? MANIFESTO UF ?
? 000111 SP ?
? 000222 RJ ?
? 000333 SP ?
? 000444 RJ ?
? ... etc ... ?
? ... etc ... ?
? ... etc ... ?
? [CONFIRMAR] [CANCELAR] ?
??????????????????????????????????????????????????????

- As linhas devem ser esparçadas o suficiente para não haver dificuldade de seleção.

- Cada linha clicada deve alternar entre estar selecionada ou não selecionada.

- O motorista vai selecionar os manifestos (um ou mais) e depois clicar no botão
[CONFIRMAR] ou [CANCELAR].

03) Detalhamento dos botões:

Se clicar no botão [CANCELAR], basta fechar a tela e retornar p/ tela principal.

Se clicar no botão [CONFIRMAR]:

- Verificar se algum manifesto está selecionado ou dar mensagem de erro "Nenhum
manifesto foi selecionado" e permanecer na tela atual.

- Testar caminho da rede igual item 03 da opção "IMPORTAR LISTA DE MANIFESTOS".

- Gravar arquivo texto na pasta configurada contendo a lista de manifestos
selecionados pelo motorista.

O nome do arquivo será composto pelo CPF do motorista seguido da hora atual do
sistema no formato "hhmmss" para evitar sobreposição de arquivos caso o motorista
execute a rotina mais de uma vez. Exemplo do nome do arquivo:
"//192.168.0.1/pasta/12345678901183012.txt" (pasta configurada, CPF, 18:30:12 hs)

Caso o APP não consiga gravar o arquivo, dar mensagem de erro correspondente e
permanecer na tela para o usuário resolver o problema e tentar gravar de novo.
Evitar mensagens genéricas que não ajudam em nada e já indicar possíveis soluções
na própria mensagem.

????????????????????????????????????????????????????????????????????????
? Não foi possível gravar lista de manifestos na rede. ?
? > Verificar se a tela de CONFIGURAÇÕES está preenchida corretamente ?
? > Verificar se celular está conectado na rede da empresa ?
? [OK] ?
????????????????????????????????????????????????????????????????????????

Gravar a lista de manifestos selecionados com o mesmo formato do arquivo de
importação. Exemplo de arquivo gravado:

CPF;PLACA;MANIFESTO;UF
**********;ABC1234;000111;SP
**********;ABC1234;000222;RJ
**********;CBA9X12;000333;SP
**********;CBA9X12;000444;RJ

04) Após a gravação do arquivo, apagar os manifestos selecionados da lista completa
importada e depois retornar para a tela principal do APP.

Essa limpeza é importante para evitar que o mesmo manifesto seja encerrado
mais de uma vez.

-------------
ACESSO À REDE
-------------

O programador não precisa se preocupar com a conexão do celular com nossa rede porque
o celular já estará conectado via VPN, mesmo que esteja fora da empresa. Fazer o
programa como se estivesse sempre na rede local.

A tecnologia para acesso à pasta da rede para leitura e gravação do arquivo texto
fica a cargo do programador. A pasta estará em um servidor Linux CentOS-7 e o acesso
será controlado por usuário e senha. Funciona bem com protocolo SMB.

Gilberto Barreto
(**********