Coffee lines

A tela Coffee lines é onde você acompanha seu estoque de café verde. Ela é organizada em três níveis: Coffee Lines, Lots e Warehouses. Os armazéns são gerenciados em Settings → Warehouses.

Abra a tela em Coffee lines, na barra lateral, ou pressione G then C. Antes do Rostoc 0.4.6, essa tela se chamava Greens.

Tela Coffee lines no Rostoc

Encontrar um café

Acima da tabela, cinco predefinições reduzem a lista para uma pergunta por vez:

Preset	Exibe
At Risk	Coffee Lines cuja previsão de término está próxima o suficiente para exigir ação
In Use	Coffee Lines das quais você está torrando no momento
Low Stock	Coffee Lines abaixo do limite de estoque baixo definido por você
By Warehouse	Coffee Lines com estoque em um armazém escolhido
Oldest	A lista completa, começando pela Coffee Line mais antiga

Search coffee lines pesquisa por nome, país, processo, variedade e produtor. Os menus Status, Country e Process refinam ainda mais a busca. Tudo, exceto Oldest, é ordenado por urgência: o que está mais perto de acabar aparece primeiro.

Scan, no menu … à direita do cabeçalho da página, abre o scanner. Assim, um leitor de código de barras ou uma etiqueta digitalizada leva você diretamente ao Lot ao qual ela pertence. Consulte Labels and codes.

Coffee Lines

Uma Coffee Line é uma categoria de café torrada continuamente — por exemplo, “Ethiopia Yirgacheffe Washed” ou “Brazil Natural”. Ela agrupa todos os Lots recebidos para esse mesmo objetivo ao longo do tempo, permitindo acompanhar o estoque e comparar bateladas entre entregas.

Criar uma Coffee Line

Clique em Create Coffee Line e preencha:

Field	O que significa
Name	Um nome curto e reconhecível (obrigatório)
Country	País de origem (obrigatório)
Region	Região produtora dentro do país (por exemplo, Yirgacheffe)
Producer/Farm	Nome do produtor ou da fazenda
Variety	Variedade do café (por exemplo, Heirloom, Gesha)
Process	Método de processamento (por exemplo, Washed, Natural, Honey)
Altitude (m)	Altitude de cultivo em metros
Supplier	Seu importador ou corretor de café verde
Low Stock Threshold (kg)	Abaixo desse peso, a Coffee Line aparece como Low stock no menu Status e na predefinição Low Stock
Sensorial Notes	Perfil de sabor, descrição de cupping ou outro contexto sensorial

Visão geral do estoque

Cada linha da tabela mostra o estoque da Coffee Line, a previsão de término em semanas com base no uso recente, quanto foi torrado dela e sua última atividade. A cor da previsão muda conforme o estoque se aproxima do fim. Quando a linha tem café a caminho, uma frase abaixo da previsão informa quando ele chega, por exemplo 60 kg on order, arrives 28 Oct 2026, before run-out; a página da própria Coffee Line mostra a mesma frase abaixo da previsão.

Abra uma Coffee Line para ver o estoque disponível, o Lot em uso, seus Lots e a previsão de término, com um gráfico do estoque e do fluxo de transações entre todos os seus Lots.

Editar, adicionar um Lot ou arquivar

Clique em uma linha para abrir a Coffee Line. O menu … no fim de cada linha contém Add Order, Add lot, Edit coffee line e Archive, o mesmo menu que a Coffee Line tem na tela inicial e no Inventory. Add Order abre um novo pedido para esse café sem sair da lista. Na página da própria Coffee Line, Add Order é o botão principal e os demais itens ficam no menu …. Arquivar remove da lista uma Coffee Line que você não compra mais. Se os Lots ainda têm estoque, o diálogo informa quanto e pergunta o que acontece com os Remaining lots: Keep in inventory os mantém como estão; Finish finaliza cada Lot em zero com o motivo que você escolher, e as linhas de fechamento aparecem na página Due diligence do Inventory.

Arquivada é um status: escolha Archived (ou All) no menu Status para vê-las, e a coluna Status mostra Archived. Os outros status são Active (o padrão, todas as linhas não arquivadas), In stock, Low stock e Out of stock. Para restaurar uma linha, escolha Restore no menu … da linha ou na página dela, onde Restore substitui Add Order enquanto ela está arquivada. Lots finalizados ao arquivar continuam finalizados; reabra um pela página do Lot.

Lots

Um Lot é uma entrega ou compra específica dentro de uma Coffee Line. Clique em uma Coffee Line para abrir sua página de detalhes e ver todos os seus Lots.

Encontrar um Lot

Acima dos Lots de uma Coffee Line, Search lots pesquisa pelo código do Lot, nota fiscal, classificação, ano da safra e observações. O menu Status reduz a lista a In Stock, Arrived, In Transit, Ordered ou Finished. Quando há mais de um armazém, o menu Warehouse mostra os Lots de um deles. Clear Filters restaura a lista completa.

Lots finalizados permanecem ocultos até você ativar Show finished lots. Em listas longas, mais Lots aparecem conforme você rola a página.

Adicionar um Lot

Dentro de uma Coffee Line, abra o menu … ao lado de Add Order e escolha Add lot. Cada Lot recebe um código gerado automaticamente, que pode ser usado em todo o Rostoc. Esse código também pode ser impresso em uma etiqueta para o saco recebido.

Basic details

Field	O que significa
Initial Weight (kg)	Peso total de café verde recebido (obrigatório; não pode ser alterado depois — use Settings de estoque)
Purchase Date	Quando o café foi pedido ou comprado
Arrival Date	Quando o café chegou à sua torrefação
Cost per kg	Custo do café verde por quilo, na moeda paga. Um novo Lot começa com o último preço pago por essa Coffee Line.
Warehouse	Local de armazenamento deste Lot. Para alterá-lo depois, mova o Lot.
Notes	Observações adicionais sobre a entrega

Quality control

Field	O que significa
Crop Year	Ano da colheita (por exemplo, 2024)
Grade	Classificação de qualidade (por exemplo, SHB, EP)
Screen Size	Faixa de peneira (por exemplo, 15-18)
Moisture (%)	Percentual de umidade
Water Activity (aw)	Medição da atividade de água
Density (g/mL)	Densidade dos grãos

O Lot em uso

O ícone de estrela marca o Lot do qual você está torrando no momento. O Rostoc o atualiza automaticamente: torrar a partir de um Lot faz dele o Lot em uso. Quando uma Coffee Line tem exatamente um Lot, não há nada para escolher. Marcar um Lot manualmente serve para quando você move um novo saco do armazenamento para a torrefação antes da primeira torra. Ao marcá-lo, o Lot anterior dessa Coffee Line deixa de ser o selecionado, sem alterar seu histórico de torra ou estoque.

Ao preparar uma torra, o Rostoc pré-seleciona o Lot em uso. Se vários Lots ainda não tiverem histórico, o Rostoc pergunta qual usar em vez de tentar adivinhar.

Pedir café verde

Quando um café estiver acabando, peça a próxima entrega sem sair da página: Add Order na Coffee Line cria um pedido com quantidade, preço (preenchido com base no seu Lot mais recente), fornecedor, data prevista de chegada e link de rastreamento. Pedidos em aberto aparecem na seção Incoming da Coffee Line até chegarem; clique em um para abrir a página do pedido. Pedidos recebidos e cancelados passam para a lista Orders, mais abaixo na página.

Um pedido avança conforme o que realmente acontece: Draft enquanto você decide, On order depois da confirmação (a nota fiscal foi paga) e Received quando o café chega. O menu … de cada pedido aberto contém Confirm (em um rascunho), Receive, Edit e Cancel order. Você pode cancelar um rascunho ou pedido ainda não recebido a qualquer momento. O Rostoc pede confirmação, pois um pedido cancelado não pode ser reaberto. Cancelar um pedido confirmado pergunta o motivo: Supplier could not deliver, Ordered by mistake, Bought elsewhere, Price or terms changed, No longer needed ou Other, com suas próprias palavras. O motivo fica no histórico do pedido. Um pedido recebido é permanente, porque seus Lots agora fazem parte do seu estoque.

Receiving é onde o pedido se transforma em Lots. Informe os pesos conforme chegaram — dois sacos de 60 kg e um saco de 30 kg podem ser três linhas ou duas, conforme você quiser acompanhar — e cada linha se torna um Lot com o preço do pedido e a referência da nota fiscal já preenchidos e vinculados ao pedido. O total recebido não precisa corresponder à quantidade pedida: o que chegou é o que conta. Abaixo das linhas, o Rostoc soma o que você informou e compara com o que foi pedido, por exemplo 118.5 kg entered of 120 kg ordered e 1.5 kg less than ordered, para que uma entrega incompleta fique clara antes de você salvar.

Finalizar um Lot

Quando um Lot acabar ou você deixar de torrá-lo, escolha Finish no menu … do Lot. Um Lot finalizado mostra zero. Ele deixa de ser o Lot em uso, não é oferecido ao escolher um Lot para uma torra e fica oculto na Coffee Line, a menos que você ative Show finished lots.

Se o Lot ainda mostrar estoque, o Rostoc pergunta o motivo antes de finalizá-lo. A caixa de diálogo informa o que será registrado — por exemplo, “ainda contém 12,57 kg. Finalizar registra -12,57 kg para que o valor seja zero” — e você escolhe um motivo. Se mais café tiver sido torrado do que o Lot continha, a linha será positiva. Uma diferença de até 100 g é comum no fim de um Lot, então Bag-end difference já vem selecionado. Um Lot que já mostra zero é finalizado imediatamente, sem pergunta.

Os motivos para finalizar são:

Bag-end difference
Entered by mistake
Count or weighing
Sample or loss
Roast not recorded in Rostoc
Other — descreva o que aconteceu com suas próprias palavras

Clique em Finish lot para confirmar. A linha aparece no histórico do Lot como Closed, com o motivo ao lado.

Encerrar um Lot finalizado

Uma torra ainda pode ser registrada em um Lot depois que ele foi finalizado — por exemplo, uma torra registrada em outro computador antes que ele recebesse a informação da finalização. O Rostoc mantém a torra. A linha mostra Roasted after finish, e o Lot fica abaixo de zero.

Quando um Lot finalizado deixa de mostrar zero, o menu … oferece Close out. O Rostoc solicita um motivo, como em Finish, e registra a linha que leva o Lot de volta a zero. O Lot continua finalizado.

Reabrir um Lot

Escolha Reopen no menu … de um Lot finalizado para usá-lo novamente. Reabrir desfaz as linhas que o fecharam, fazendo o Lot voltar ao estoque anterior à finalização. Cada linha desfeita aparece como Reopened no histórico. O Lot volta ao estoque ou aparece como estoque baixo se estiver abaixo do limite da Coffee Line. Um Lot reaberto com zero ou menos permanece aberto para que você possa ajustá-lo.

Um Lot finalizado não pode ser ajustado, dividido ou movido. Reabra-o primeiro.

Settings de estoque

O Rostoc acompanha o consumo automaticamente conforme os Batches são registrados. Para corrigir o estoque — por exemplo, após uma contagem física ou uma perda — abra o menu … do Lot, no fim da linha ou à direita do cabeçalho da página do Lot, e escolha Adjust stock.

Informe o New Stock que o Lot deve mostrar ou a Weight Change como número positivo ou negativo. O Rostoc preenche o outro valor. Depois, escolha um Reason:

Roast not recorded in Rostoc
Entered by mistake
Count or weighing
Sample or loss
New delivery — uma nova entrega é mais fácil de rastrear como um Lot separado, então o Rostoc oferece Add a lot instead
Moved to another lot — mover café entre Lots é uma divisão, então o Rostoc oferece Use split instead
Other — descreva o que aconteceu com suas próprias palavras

Details é opcional para os demais motivos. Clique em Apply. A linha aparece no histórico de estoque como Adjustment, com o motivo e suas palavras ao lado — por exemplo, “Count or weighing · Recounted”.

Dividir um Lot

A divisão de um Lot permite mover parte do estoque para um Lot novo ou existente. Escolha Split stock no menu … de um Lot, informe o peso a dividir em kg, escolha o destino, adicione um motivo opcional e confirme.

Você pode dividir para um New lot em um armazém ou para um Existing lot. O Rostoc registra os dois lados: uma linha de saída no Lot de origem e uma linha de entrada no Lot de destino. Ambas aparecem como Transfer, com um link para o outro Lot (→ na origem e ← no destino).

Use essa opção para enviar parte de uma entrega para outro armazém, separar estoque para torra de amostras ou redistribuir café verde entre Lots.

Mover um Lot para outro armazém

Para mover um Lot inteiro, escolha Move to another warehouse no menu …, selecione o armazém em Move to e clique em Move lot. O estoque não muda, e o histórico registra a movimentação como Moved.

Move to another warehouse aparece quando há mais de um armazém e somente em Lots que não foram finalizados. Edit Lot mostra o armazém do Lot, mas não o altera: a movimentação é a única forma de fazer essa mudança.

Histórico de estoque

A tabela de histórico de transações mostra cada evento que alterou o nível de estoque de um Lot, identificado por um tipo:

Type	Significado
Receipt	Entrada inicial de estoque quando o Lot foi criado
Roast	Consumo registrado a partir de um Batch
Roasted after finish	Torra registrada no Lot depois de ele ser finalizado
Adjustment	Correção manual aplicada por meio de Adjust stock
Closed	Linha que levou o Lot a zero ao finalizá-lo ou encerrá-lo
Reopened	Linha de fechamento desfeita quando o Lot foi reaberto
Transfer	Estoque movido de ou para outro Lot por uma divisão, com link para o outro Lot
Moved	Lot movido para outro armazém; o estoque não muda
Reversal	Consumo de uma torra devolvido, por exemplo, ao corrigir qual Lot foi usado

A coluna Reason mostra o que você escolheu e escreveu. Linhas registradas antes da introdução dos motivos exibem o texto original.

Isso fornece um registro completo de como o estoque se movimentou ao longo do tempo.

Importar de uma planilha

Se você já acompanha seus cafés verdes em uma planilha, pode importá-los diretamente em vez de adicionar Coffee Lines e Lots manualmente.

Clique em Import File na tela Coffee lines para abrir o assistente de importação. Ele orienta você por quatro etapas:

Pick file — selecione um arquivo CSV, XLS ou XLSX no computador.
Map columns — associe os cabeçalhos das colunas do arquivo aos campos do Rostoc. Uma predefinição Cropster preset está disponível se o arquivo foi exportado do Cropster.
Preview — revise os dados interpretados antes que algo seja salvo. Linhas com erros são sinalizadas.
Import — o Rostoc cria Coffee Lines e Lots a partir dos dados associados.

O Rostoc compara cada linha com as Coffee Lines existentes — pelo ID de origem no arquivo, se houver, ou então pelo nome, país e processo em conjunto. Executar o mesmo arquivo novamente atualiza os dados existentes em vez de duplicá-los.

Armazéns

Armazéns são locais físicos ou lógicos de armazenamento que você quer acompanhar — por exemplo, “Main Store” ou “Sample Room”. Eles são gerenciados em Settings → Warehouses.

Adicionar um armazém

Acesse Settings → Warehouses, clique em Add Warehouse e dê um nome ao armazém. Depois de criado, ele aparece como opção ao adicionar, dividir ou mover um Lot.

Os armazéns ajudam você a saber não apenas quanto possui, mas também onde está.

Excluir um armazém

Quando você exclui um armazém que contém Lots, o Rostoc informa primeiro quantos existem — por exemplo, “3 lots in Main Store will no longer have a warehouse.” Os Lots são mantidos, com seu estoque e histórico, mas deixam de ter um armazém.