]> git.stg.codes - stg.git/blob - doc/help/ch12.xml
Remove redundand ctors.
[stg.git] / doc / help / ch12.xml
1 <chapter xml:id="ch12">
2     <title>Приложение В</title>
3         <simplesect>
4         <title>Описание процесса ручной установки БД для СУБД Firebird</title>
5         <para>Для работы модуля необходимо завести учетную запись пользователя СУБД Firebird. Для этого используется утилита управления учетными записями gsec. Пример создания пользователя (подробности: Server configuration and management):</para>
6 <programlisting linenumbering="unnumbered">
7 # gsec -user sysdba -password masterkey
8 GSEC&gt; add stg -pw 123456
9 </programlisting>
10         <para>Для корректной работы модуля пользователь должен иметь право на запись и чтение данных в таблицы БД.</para>
11         <para>Модуль для работы с СУБД Firebird требует наличия правильно созданной базы данных. SQL-скрипт для создания находится в каталоге projects/stargazer/inst/var/00-base-00.sql. В обычных условиях выполнение make install или make install-data автоматически создает базу данных, используя этот скрипт. Для того чтобы создать ее вручную необходимо в файле SQL-скрипта раскомментировать строки:
12 <programlisting linenumbering="unnumbered">
13 connect 'localhost:/var/stg/stargazer.fdb' user 'stg' password '123456';
14 drop database;
15 create database 'localhost:/var/stg/stargazer.fdb' user 'stg' password '123456' default character set win1251;
16 </programlisting>
17         и заменить в них адрес сервера, путь к базу, имя пользователя БД и пароль. После этого выполнить команду isql -i &lt;файл_скрипта&gt;.</para>
18         <formalpara>
19                 <title>Внимание!</title>
20                 <para>Для пользователей Debian и, возможно, некоторых других дистрибутивов командный интерпретатор SQL для СУБД Firebird называется isql-fb.</para>
21         </formalpara>
22         </simplesect>
23         <simplesect>
24         <title>Описание структуры БД для СУБД Firebird</title>
25         <para>Таблица tb_admins (учетные записи администраторов системы):</para>
26         <itemizedlist mark="opencircle">
27                 <listitem><para>pk_admin – уникальный идентификатор учетной записи администратора;</para></listitem>
28                 <listitem><para>login – название учетной записи администратора;</para></listitem>
29                 <listitem><para>passwd – пароль для учетной записи администратора (в зашифрованном виде);</para></listitem>
30                 <listitem><para>chg_conf – флаг, позволяющий менять конфигурационные параметры пользователя;</para></listitem>
31                 <listitem><para>chg_password – флаг, позволяющий менять пароль пользователя;</para></listitem>
32                 <listitem><para>chg_stat – флаг, позволяющий менять статистические данные пользователя;</para></listitem>
33                 <listitem><para>chg_cash – флаг, позволяющий менять количество денег на счету у пользователя;</para></listitem>
34                 <listitem><para>usr_add_del – флаг, позволяющий удалять и добавлять пользователей;</para></listitem>
35                 <listitem><para>chg_tariff – флаг, позволяющий управлять тарифами;</para></listitem>
36                 <listitem><para>chg_admin – флаг, позволяющий управлять учетными записями администраторов системы;</para></listitem>
37                 <listitem><para>chg_service – зарезервировано;</para></listitem>
38                 <listitem><para>chg_corporation – зарезервировано.</para></listitem>
39         </itemizedlist>
40         <para>С таблицей связан триггер tr_admin_bi, выполняющий автогенерацию идентификатора (первичного ключа) учетных записей администраторов системы.</para>
41         <para>Таблица tb_tariffs (описание тарифов):</para>
42         <itemizedlist mark="opencircle">
43                 <listitem><para>pk_tariff – уникальный идентификатор тарифа;</para></listitem>
44                 <listitem><para>name – название тарифа;</para></listitem>
45                 <listitem><para>fee – абонплата;</para></listitem>
46                 <listitem><para>free – количество бесплатных мегабайт трафика, входящих в абонплату;</para></listitem>
47                 <listitem><para>passive_cost – стоимость «заморозки» пользователя;</para></listitem>
48                 <listitem><para>traf_type – тип подсчета трафика (upload, download, upload+download, MAX(upload, download)).</para></listitem>
49         </itemizedlist>
50         <para>С таблицей связана хранимая процедура sp_add_tariff, получающая в качестве параметров название тарифа и количество направлений. Возвращает сгенерированный идентификатор (первичный ключ) тарифа. При вызове создает запись в таблице tb_tariffs и указанное количество записей в таблице tb_tariffs_params, соответствующее количеству направлений. С таблицей так же связана хранимая процедура sp_delete_tariff, получающая на вход название тарифа и удаляющая его из таблицы tb_tariffs и связанные с ним данные из таблицы tb_tariffs_params.</para>
51         <para>Таблица tb_tariffs_params (параметры тарифов):</para>
52         <itemizedlist mark="opencircle">
53                 <listitem><para>pk_tariff_param – уникальный идентификатор записи информации о направлении в тарифе;</para></listitem>
54                 <listitem><para>fk_tariff – внешний ключ для связи с тарифом;</para></listitem>
55                 <listitem><para>dir_num – номер направления;</para></listitem>
56                 <listitem><para>price_day_a – стоимость 1 Мб трафика днем до превышения порога;</para></listitem>
57                 <listitem><para>price_day_b – стоимость 1 Мб трафика днем после превышения порога;</para></listitem>
58                 <listitem><para>price_night_a – стоимость 1 Мб трафика ночью до превышения порога;</para></listitem>
59                 <listitem><para>price_night_b – стоимость 1 Мб трафика ночью после превышения порога;</para></listitem>
60                 <listitem><para>threshold – порог по трафику;</para></listitem>
61                 <listitem><para>time_day_begins – время начала дня;</para></listitem>
62                 <listitem><para>time_day_ends – время конца дня.</para></listitem>
63         </itemizedlist>
64         <para>С таблицей связан триггер tr_tariffs_params_bi, выполняющий автогенерацию идентификаторов записей (первичных ключей) в таблице.</para>
65         <para>Таблица tb_corporations – зарезервирована.</para>
66         <para>С таблицей связан триггер tr_corporations_bi, выполняющий автогенерацию первичных ключей.</para>
67         <para>Таблица tb_users (учетные записи пользователей системы):</para>
68         <itemizedlist mark="opencircle">
69                 <listitem><para>pk_user – уникальный идентификатор пользователя;</para></listitem>
70                 <listitem><para>fk_tariff – внешний ключ для связи с тарифом;</para></listitem>
71                 <listitem><para>fk_tariff_change – внешний ключ для связи с тарифом (может быть пустым);</para></listitem>
72                 <listitem><para>fk_corporation – зарезервировано;</para></listitem>
73                 <listitem><para>address – адрес пользователя;</para></listitem>
74                 <listitem><para>always_online – флаг «всегда on-line»;</para></listitem>
75                 <listitem><para>credit – величина кредита в деньгах;</para></listitem>
76                 <listitem><para>credit_expire – дата окончания действия кредита;</para></listitem>
77                 <listitem><para>disabled_detail_stat — отключение детальной статистики пользователя;</para></listitem>
78                 <listitem><para>disabled – флаг «отключен»;</para></listitem>
79                 <listitem><para>email – email пользователя;</para></listitem>
80                 <listitem><para>grp – название группы пользователя;</para></listitem>
81                 <listitem><para>note – примечание;</para></listitem>
82                 <listitem><para>passive – флаг «заморозки»;</para></listitem>
83                 <listitem><para>passwd – пароль пользователя (в открытом виде);</para></listitem>
84                 <listitem><para>phone – номер телефона пользователя;</para></listitem>
85                 <listitem><para>name – название учетной записи пользователя (логин);</para></listitem>
86                 <listitem><para>real_name – реальное имя пользователя.</para></listitem>
87         </itemizedlist>
88         <para>С таблицей связана хранимая процедура sp_add_user, принимающая на вход 2 параметра: название учетной записи пользователя и количество направлений. Возвращает сгенерированное значение первичного ключа. При вызове создает запись в таблице tb_users, соответствующую ей запись в таблице tb_stats и указанное количество записей в таблице tb_stats_traffic. Так же с таблицей связана хранимая процедура sp_delete_user, получающая в качестве входного параметра название учетной записи (логин) пользователя и удаляющая учетную запись и всю сопутствующую информацию (данные пользователя, IP-адреса, сообщения, журналы параметров, статистику и детальную статистику, журналы сессий) о пользователе из базы.</para>
89         <para>Таблица tb_detail_stats (детальная статистика по пользователям системы):</para>
90         <itemizedlist mark="opencircle">
91                 <listitem><para>pk_detail_stat – уникальный идентификатор записи детальной статистики;</para></listitem>
92                 <listitem><para>fk_user – внешний ключ для связи с пользователем;</para></listitem>
93                 <listitem><para>dir_num – номер направления;</para></listitem>
94                 <listitem><para>ip – удаленный IP-адрес (в формате 32-битного беззнакового целого);</para></listitem>
95                 <listitem><para>download – количество принятых байт;</para></listitem>
96                 <listitem><para>upload – количество отправленных байт;</para></listitem>
97                 <listitem><para>cost – стоимость объема данных;</para></listitem>
98                 <listitem><para>from_time – время начала сессии;</para></listitem>
99                 <listitem><para>till_time – время завершения сеанса.</para></listitem>
100         </itemizedlist>
101         <para>С таблицей связан триггер tr_detail_stats_bi, выполняющий автогенерацию уникальных идентификаторов записей детальной статистики (первичных ключей).</para>
102         <para>Таблица tb_services – зарезервирована. С ней связан триггер tr_services_bi, выполняющий автогенерацию первичных ключей. Так же с ней связана хранимая процедура sp_delete_service, удаляющая всю информацию связанную с записью в данной таблице.</para>
103         <para>Таблица tb_users_services – зарезервирована. С ней связан триггер tr_users_services_bi, выполняющий автогенерацию первичных ключей.</para>
104         <para>Таблица tb_messages (сообщения пользователям):</para>
105         <itemizedlist mark="opencircle">
106                 <listitem><para>pk_message – уникальный идентификатор сообщения;</para></listitem>
107                 <listitem><para>fk_user – внешний ключ для связи с пользователем;</para></listitem>
108                 <listitem><para>ver – версия формата сообщения;</para></listitem>
109                 <listitem><para>msg_type – тип сообщения;</para></listitem>
110                 <listitem><para>last_send_time – время последней отсылки сообщения;</para></listitem>
111                 <listitem><para>creation_time – время создания сообщения;</para></listitem>
112                 <listitem><para>show_time – время показа сообщения;</para></listitem>
113                 <listitem><para>repeat – количество повторений;</para></listitem>
114                 <listitem><para>repeat_period – период повторения;</para></listitem>
115                 <listitem><para>msg_text – текст сообщения.</para></listitem>
116         </itemizedlist>
117         <para>С таблицей связана хранимая процедура sp_add_message, которая получает на вход идентификатор, параметры и текст сообщения. В случае если идентификатор пустой – сообщение добавляется в таблицу. Если не пустой – параметры и текст сообщения обновляются. Процедура возвращает идентификатор сообщения.</para>
118         <para>Таблица tb_stats (статистика пользователя):</para>
119         <itemizedlist mark="opencircle">
120                 <listitem><para>pk_stat – уникальный идентификатор записи статистики;</para></listitem>
121                 <listitem><para>fk_user – внешний ключ для связи с пользователем;</para></listitem>
122                 <listitem><para>cash – количество денег на счету;</para></listitem>
123                 <listitem><para>free_mb – количество не истраченных бесплатных Мб;</para></listitem>
124                 <listitem><para>last_activity_time – время последней активности пользователя;</para></listitem>
125                 <listitem><para>last_cash_add – последнее пополнение счета;</para></listitem>
126                 <listitem><para>last_cash_add_time – время последнего пополнения счета;</para></listitem>
127                 <listitem><para>passive_time – время, проведенное пользователем в «замороженном» состоянии за месяц (используется для вычисления объема снимаемой абонплаты);</para></listitem>
128                 <listitem><para>stats_date – дата записи статистики (месячной статистики).</para></listitem>
129         </itemizedlist>
130         <para>С таблицей связана хранимая процедура sp_add_stat, получающая на вход набор данных статистики, добавляющая запись в таблицу и возвращающая сгенерированный первичный ключ записи.</para>
131         <para>Таблица tb_stats_traffic (статистика по направлениям):</para>
132         <itemizedlist mark="opencircle">
133                 <listitem><para>pk_stat_traffic – уникальный идентификатор записи статистики;</para></listitem>
134                 <listitem><para>fk_stat – внешний ключ для связи со статистикой пользователя (текущей или месячной);</para></listitem>
135                 <listitem><para>dir_num – номер направления;</para></listitem>
136                 <listitem><para>download – объем входящего трафика;</para></listitem>
137                 <listitem><para>upload – объем исходящего трафика.</para></listitem>
138         </itemizedlist>
139         <para>С таблицей связан триггер tr_stat_traffic_bi, служащий для автогенерации первичного ключа.</para>
140         <para>Таблица tb_users_data (данные пользователя):</para>
141         <itemizedlist mark="opencircle">
142                 <listitem><para>pk_user_data – уникальный идентификатор записи;</para></listitem>
143                 <listitem><para>fk_user – внешний ключ для связи с пользователем;</para></listitem>
144                 <listitem><para>num – номер поля данных;</para></listitem>
145                 <listitem><para>data – текст поля данных.</para></listitem>
146         </itemizedlist>
147         <para>С таблицей связан триггер tr_user_data_bi, служащий для автогенерации первичного ключа.</para>
148         <para>Таблица tb_allowed_ip (IP-адреса пользователя):</para>
149         <itemizedlist mark="opencircle">
150                 <listitem><para>pk_allowed_ip – уникальный идентификатор записи;</para></listitem>
151                 <listitem><para>fk_user – внешний ключ для связи с пользователем;</para></listitem>
152                 <listitem><para>ip – IP-адрес (в формате 32-битного беззнакового целого);</para></listitem>
153                 <listitem><para>mask – маска (в формате 32-битного беззнакового целого).</para></listitem>
154         </itemizedlist>
155         <para>С таблицей связан триггер tr_allowed_ip_bi, служащий для автогенерации первичного ключа.</para>
156         <para>Таблица tb_sessions_log (журнал сессии):</para>
157         <itemizedlist mark="opencircle">
158                 <listitem><para>pk_session_log – уникальный идентификатор записи в журнале;</para></listitem>
159                 <listitem><para>fk_user – внешний ключ для связи с пользователем;</para></listitem>
160                 <listitem><para>event_time – время события;</para></listitem>
161                 <listitem><para>event_type – тип события (connect/disconnect);</para></listitem>
162                 <listitem><para>ip – IP-адрес пользователя.</para></listitem>
163         </itemizedlist>
164         <para>С таблицей связана хранимая процедура sp_append_session_log, получающая в качестве параметров данные для записи в журнал сессии. Добавляет запись в журнал и возвращает сгенерированный первичный ключ.</para>
165         <para>Таблица tb_sessions_data (данные сессии):</para>
166         <itemizedlist mark="opencircle">
167                 <listitem><para>pk_session_data – уникальный идентификатор записи данных;</para></listitem>
168                 <listitem><para>fk_session_log – внешний ключ для связи с записью в журнале сессии;</para></listitem>
169                 <listitem><para>dir_num – номер направления;</para></listitem>
170                 <listitem><para>session_upload – объем исходящего трафика за сессию;</para></listitem>
171                 <listitem><para>session_download – объем входящего трафика за сессию;</para></listitem>
172                 <listitem><para>month_upload – объем исходящего трафика за месяц;</para></listitem>
173                 <listitem><para>month_download – объем входящего трафика за месяц.</para></listitem>
174         </itemizedlist>
175         <para>С таблицей связан триггер tr_session_data_bi, служащий для автогенерации первичного ключа.</para>
176         <para>Таблица tb_parameters (параметры пользователя):</para>
177         <itemizedlist mark="opencircle">
178                 <listitem><para>pk_parameter – уникальный идентификатор параметра;</para></listitem>
179                 <listitem><para>name – название параметра.</para></listitem>
180         </itemizedlist>
181         <para>С таблицей связан триггер tr_parameter_bi, служащий для автогенерации первичного ключа.</para>
182         <para>Таблица tb_params_log (журнал изменений параметров пользователя):</para>
183         <itemizedlist mark="opencircle">
184                 <listitem><para>pk_param_log – уникальный идентификатор записи в журнале изменений параметров пользователя;</para></listitem>
185                 <listitem><para>fk_user – внешний ключ для связи с пользователем;</para></listitem>
186                 <listitem><para>fk_parameter – внешний ключ для связи с таблицей параметров;</para></listitem>
187                 <listitem><para>event_time – время изменения;</para></listitem>
188                 <listitem><para>from_val – старое значение (в виде строки);</para></listitem>
189                 <listitem><para>to_val – новое значение (в виде строки);</para></listitem>
190                 <listitem><para>comment – коментарий.</para></listitem>
191         </itemizedlist>
192         <para>С таблицей связан триггер tr_param_log_bi, служащий для автогенерации первичного ключа.</para>
193          <para>
194          <mediaobject>
195             <imageobject>
196                 <imagedata fileref="images/firebird-erd.png" format="PNG"/>
197             </imageobject>
198         </mediaobject>
199         </para> 
200         </simplesect>
201 </chapter>