O manual do utilizador do GARDENIA, contendo instruções de instalação e utilização ainda não está disponível.
Pode encontrar informação adicional nos seguintes links:

• README.pt.txt - Informação geral e créditos
• README.en.txt - Informação geral e créditos, em inglês
• README.source.txt - README (em inglês) que acompanha o código fonte. Contém instruções para compilação a partir do sourcecode e para instalação do GARDENIA Enterprise Edition.
• Licence-LGPL.txt - Licença de utilização (LGPL) em português e inglês
• Forum de Discussão Geral - Forum de discussão do GARDENIA. A melhor referência para resolver duvidas. Constantemente monitorizado pela equipa de desenvolvimento.
• Pagina do projecto em SourceForge - Pagina do projecto GARDENIA no SourceForge (website para alojamento de projectos open-source). Links para download do código fonte e pacotes de instalação, forums de discussão, listas de email, repositório CVS do codigo fonte, pedidos de novas funcionalidades, gestão de bugs, etc.

Instruções de Instalação - GARDENIA Desktop Edition

Faça download do programa de instalacao do Gardenia Desktop Edition. Existem 2 versões, uma para todos os sistemas operativos (gardenia-desktop-0.9.xx-installer.jar), e outra apenas para os sistemas windows ( gardenia-desktop-0.9.xx-installer-win32.exe), que inclui o JRE - JAVA Runtime Environment .
Nota: Caso já possua o JRE (Java Runtime Environment) instalado no seu computador, e recomendado a versão ".jar", visto ser de menor tamanho.
Para instalar faca "double-click" sobre o ficheiro de instalação, ou (em unix/linux, para a versao ".jar") escreva na linha de comandos: java -jar gardenia-desktop-0.9.xx-installer.jar
Siga as instruções de instalacao do Wizard. Ao terminar a instalação, serao criados icons para lancar o GARDENIA Desktop Edition no seu desktop.
Nota: Em alternativa pode utilizar o script "gardenia.sh" (unix) ou "gardenia.bat" (windows) para iniciar o gardenia (disponiveis na sub-directoria "bin" sob a directoria de instalação do GARDENIA. Ex: /home/appj/GardeniaDesktop/bin/gardenia.sh, ou C:\Program Files\Gotham\GardeniaDesktop\bin\gardenia.bat).

Primeiro Login e Configurações Iniciais

Prima no icon do gardenia. Isto irá lancar o GARDENIA Desktop Edition. Ao premir no botao "Entrar", sera lancado o web browser, para a pagina de autenticação.

O sistema tem um utilizador (com previlégios de administração) criado, com os seguintes dados:

Utilizador: admin

Password: benfica

Por uma questão de segurança, mude a password o mais rapidamente possivel :-).

Apos o primeiro login, e para testar o sistema, sugere-se as seguintes accoes:

• Mudar a password do administrador (admin), e criar um username para cada utilizador da aplicação. No menu "Administracao/Utilizadores"
• Alterar os parâmetros de configuração do GARDENIA, nomeadamente os dados da empresa (Nome, numero de contribuinte, morada, ficheiro com logotipo), visto estes serem utilizados na criação dos documentos. Menu "Administracao/Parametros de Configuração".
• Criar Categorias de Produtos. Menu "Administracao/Categorias Produtos".
• Criar Categorias de Ocorrencias, para "Issue Tracking". Menu "Administracao/Categorias Ocorrencias".
• Verificar os prefixos e a numeração sequencial desejada para cada um dos documentos (ex, as facturas por omissao tem o prefixo "FAC-" e o numero de serie "1". Assim, a proxima factura será a "FAC-000001"). No menu "Administracao/Tipos de Documentos".
• Criar os Produtos. Menu "Produtos".
• Criar pelo menus um Cliente e um Fornecedorer, no menu "Clientes/Fornecedores"(Nota: uma entidade pode ser ao mesmo tempo cliente e também fornecedor)
• Após estes passos, já é possível criar documentos (facturas, vendas a dicheiro, etc). Aceda ao menu "Documentos - Emissão", e prima "Novo". Selectione o tipo de documento, cliente e prima "Salvar". Após isto, o documento fica no estado "Em Edição", onde é possível adicionar produtos/serviços a este.
• Note que um documento fica inicialmente no estado "Em edição". Para finalizar a criação o documento (e ter a possibilidade de imprimi-lo), deve antes alterar o seu estado para "Em Aberto", e premir "Salvar".

Informação Técnica

O Gardenia é um projecto open-source, desenvolvido em tecnologia J2EE (Java, JSP, TagLibs) e recorre a diversas frameworks open-source.
As mais utilizados são o JDBForms - http://jdbforms.sf.net para a interface e acesso aos dados, e o JasperReports - http://jasperreports.sf.net para os relatorios e para a geração de PDFs de documentos para impressão (facturas, vendas a dinheiro, etc).
Corre sobre uma servidor aplicacional web (servlet/jsp engine) como o Tomcat, e o Jetty. Para a persistência dos dados utiliza uma base de dados relacional SQL, como o Hipersonic (HSQL) e/ou o FireBirdSQL.
Toda a interface do GARDENIA é feita em ambiente WEB (Java JSPs e servlets), sob protocolo HTTP.
A versao desktop do GARDENIA e composta por uma GUI em XUL/JAVA (criada com o projecto Thinlet) que arranca com um servidor web embebido (Jetty) e uma base de dados java (HSQL), e (atraves de um botão nesse GUI) lança o browser web instalado no sistema por omissao com o endereco http://127.0.0.1/gardenia. Tanto a versao Desktop como a Enterprise partilham o mesmo codigo para a aplicacao web.
O pacote de instalacao foi criado com o IzPack (install package generator para Java), e a versão em windows do installer (também criado com o IzPack) inclui um JRE.
O procedimento de compilação e construção dos pacotes de instalacao é feito com o Jakarta ANT.
O GARDENIA é desenvolvido em Unix/Linux, e testado em Unix/Linux e Windows, com os browsers Mozilla Firefox e Internet Explorer.
O código fonte do GARDENIA está disponivel (de acordo com a licença LGPL) a partir do website do projecto em sourceforge: http://gardenia.sf.net e http://sf.net/projects/gardenia/.