ananas-labs: A C++ repository from app

_Об Ананасе_

Ананас - программная платформа автоматизации учета для Linux и Windows.
Ананас является программным обеспечением автоматизации учета,
предназначенным для использования на небольших и средних
предприятиях. Ананас позволяет автоматизировать основные
учетные операции. Ананас умеет работать на операционных
системамах Windows и GNU/Linux.

Программное обеспечение распространяется на условиях
открытой лицензии, позволяющих копировать Ананас бесплатно
и также бесплатно использовать его для ведения
автоматизированного учета на любом количестве рабочих мест. 

Получить исходники Ананаса можно с сайта http://ananas.lrn.ru
Там же можно скачать rpm для Alt Linux или Fedora Core.

Ниже описывается процесс сборки из исходных кодов.
Чтобы все собралось, необходимо наличие в системе Qt и QSA (Qt Script for Applications)

_Компиляция_

Сборка стандартная 
Распаковываем архив в каталоге /usr/src или в другом каталоге, сделав после
распаковки симлинк в /usr/src,
и переходим в каталог проекта
cd /usr/src/ananas-engine-qt

Запускаем
make
и, если собралось без ошибок,
make install 

После успешного выполнения компиляции в некоторых подкаталогах появятся 
исполняемые файлы готовые к запуску.
Первым делом необходимо запустить Анана.Дизайнер... 
смотри раздел _Использование_ ниже

_Использование_

И так сказу после успешной компиляции запускаем Ананас.Дизайнер
cd /usr/src/ananas-engine/src/designer
./ananas-designer


В нем нужно выбрать конфигурацию (в диалоге выбора конфигурации
есть возможность задать параметры доступа к серверу баз данных)
и создать базу данных на сервере, воспользовавшись пунктом меню
"Бизнес схема" -> "Сохранить".
Иногда этот процесс занимает довольно продолжительное время,
поэтому лучше не нажимать кнопочку "Сохранить" несколько раз подряд.

Теперь ваш Ананас готов к работе.
Сначала, стоит еще немного времени уделить Ананас.Дизайнеру 
В нем есть много интересного ;)
Чтобы увидеть дерево бизнес схемы, воспользуйтесь меню
"Бизнес схема" -> "Открыть"
Откроется окно с объектами бизнес схемы, организованными в виде дерева.

Во-первых, вы можете менять бизнес схему по своему усмотрению. 
Добавлять/удалять документы, поля документов, табличные части документов.
Работать с другими объектами.
После изменения бизнес схемы ее можно сохранить, а также обновить структуру 
базы данных тем же способом, которым мы ее создали выше.

Двойной щелчек по корню дерева откроет доступ к параметрам бизнес схемы и...
- Внимание!-  редактору глобального модуля Ananas.Script - месту, где определяются
общедоступные функции на встроенном в Ананас интерпретируемом языке 
программирования.
Сдесь можно увидеть определение функций
on_systemstart()
on_systemstop()
Это зарезервированные названия функций, через которые осуществляется
обработка события запуска Ананаса и события выхода из Ананаса соответственно.

Уже сейчас есть возможность создавать/настраивать экранные формы (диалоги) 
документов, и определять обработку событий нажатия на кнопки диалога.
Для того, чтобы форма работала, нужно определить обработчики событий.
Что осуществляется на закладке "Модуль" редактора свойств диалога.

Вдоволь набаловавшись с Ананас.Дизайнером, можно пойти и проверить, как работает
то, что мы "наконфигурировали" :)
Для этого нужно запустить сам Ананас
cd /usr/src/ananas-engine/src/engine
./ananas-engine
И выбрать именно ту бизнес схему, с которой мы работали 
в Ананас.Дизайнере

Во время запуска Ананаса отработает код функции
on_systemstart(), упомянутой выше.
Вот пожалуй и все, что хотелось сказать об использовании.


_Использование с PostgreSQL_

Для работы системы с сервером postgres необходимо:

1. Перед началом работы надо установить сервер postgres из вашего 
дистрибутива. Желательна версия больше 7.3

2. Настроить сервер БД для работы с TCP/IP соединением. Для этого из под 
пользователя root в файле postgresql.conf вашей системы (например, для 
ALT Linux Master 2.2 он находтится в каталоге /var/lib/pgsql/data) нужно 
прописать строку:

tcpip_socket=true

или найти и раскоментировать соответствующий параметр. Порт 5432 
используется postgres по умолчанию, но при необходимости его можно 
изменить, добавив или изменив параметр:

port=5432

Затем следует перезапустить сервер БД командой:

service postgresql restart
app/ananas-labs
