# Sementes

O Sementes adapta o WooCommerce para a venda de cestas agroecológicas e a organização de Grupos de Consumo Responsável (GCR). O plugin permite abrir períodos de encomenda, organizar fornecedores e locais de retirada e consultar relatórios de cada ciclo de vendas.

O software é desenvolvido pelo [TICDEMOS](https://cestaagroecologica.com.br/), projeto do NIDES/UFRJ, em parceria com a [Cooperativa EITA](https://eita.coop.br/).

## O que o plugin faz

- **Ciclos de vendas:** define datas e horários de abertura e fechamento das encomendas. Fora do período de compra, os produtos continuam visíveis na loja.
- **Gestão da loja:** oferece um painel simplificado para gestores e produtores e permite associar usuários produtores às suas categorias.
- **Retirada dos pedidos:** cadastra locais de retirada para organizar as entregas.
- **Relatórios por ciclo:** mostra pedidos detalhados, pedidos e totais por fornecedor, pedidos por local de retirada e combinações de local e fornecedor. Os relatórios podem ser consultados na tela ou exportados em XLSX e PDF.
- **Visão geral:** apresenta dados dos ciclos no painel inicial.

## Instalação e uso

O plugin requer WordPress e WooCommerce ativo. Para instalar a versão publicada, acesse [Sementes no diretório do WordPress.org](https://wordpress.org/plugins/sementes-cas-gcrs/) ou procure por **Sementes** em **Plugins > Adicionar plugin** no painel do WordPress.

Consulte os manuais para configurar a loja e os ciclos:

- [Manual de instalação](https://cestaagroecologica.com.br/?documento=manual-de-instalacao-sementes)
- [Manual de uso](https://cestaagroecologica.com.br/?documento=manual-de-uso-sementes)

## Desenvolvimento local

Para executar o ambiente de desenvolvimento, instale Node.js 22, npm e Docker. Na raiz do projeto, rode:

```bash
npm install
npm start
```

O comando `npm start` inicia o ambiente WordPress em contêineres e instala as dependências necessárias. A configuração do ambiente fica em `scripts/.wp-env.json`.

## Projeto e comunidade

- [Site oficial do TICDEMOS](https://cestaagroecologica.com.br/)
- [Código-fonte e registro de problemas](https://gitlab.com/eita/eitagcr)
- [Grupo no Telegram](https://t.me/+_3B74FPY5RMwNDkx)

## Licença

Distribuído sob a [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.html) ou posterior.
