Stoqのソースを表示

[[Category:オフィス]]
[[en:Stoq]]
[[pt:Stoq]]
[http://www.stoq.com.br Stoq] はオープンソースの経営管理スイートです。

Stoq アプリケーションはデータベースバックエンドとして [[PostgreSQL]] を使用します。グラフィカルインターフェイスクライアントが存在します。

== インストール ==

=== Stoq のインストール ===

{{aur|stoq}} パッケージを[[インストール]]してください。Stoq が依存する {{aur|webkitgtk}} はインストールに時間がかかります。

=== Stoq の設定 ===

最初に Stoq を起動したら、使用するデータベースを設定する必要があります。クライアントからデータベースに接続する方法は2つ存在します:

* データベースにローカルで接続。
* 手動でデータベースサーバーを設定。

==== データベースにローカルで接続 ====

データベースにローカルで接続するには {{Pkg|postgresql}} を[[インストール]]する必要があります。

PostgreSQL データベースクラスタを初期化していない場合、[[PostgreSQL#PostgreSQL のインストール]]の手順に従ってください。

root で {{ic|postgresql.service}} を[[起動]]・[[有効化]]してください。

"Database location" 画面で "I want to use Stoq just on this computer" オプションを使ってください。

==== 手動でデータベースサーバーを設定 ====

"Database location" 画面で "I want to manually configure the database connection" オプションを選択してデータベースの情報を入力してください。

==== Stoq 設定ファイル ====

Stoq のメイン設定ファイルは {{ic|~/.stoq/stoq.conf}} です。

=== stoq-server のインストール ===

{{aur|stoq-server}} パッケージを[[インストール]]してください。新しく作成される ''stoqserver'' ユーザーの[[ユーザーとグループ#ユーザーを追加する例|パスワードを設定]]してください。

=== stoq-server の設定 ===

PostgreSQL データベースクラスタを初期化していない場合、[[PostgreSQL#PostgreSQL のインストール]]の手順に従ってください。

root で {{ic|postgresql.service}} を[[起動]]・[[有効化]]してください。

stoqserver 用に新しく PostgreSQL の設定を作成する必要があります。デフォルトの PostgreSQL スーパーユーザー ('postgres') でログインするには以下のコマンドを実行:

*{{Pkg|sudo}} を使っていて {{ic|sudoers}} に設定を行っている場合:

: {{bc|$ sudo -u postgres -i}}

* sudo が使えない場合:

: {{bc|<nowiki>
$ su
# su -l postgres
</nowiki>}}

stoqsconf スクリプトを使って必要な設定ファイルを生成:

 [postgres]$ stoqsconf -p 5432 -D "/usr/share/stoqserver"

* {{ic|-p}} は PostgreSQL でリモートで接続するときに使用するポートです。
* {{ic|-D}} は stoq-server の設定ファイルを保存するディレクトリのパスです。

{{ic|exit}} で通常ユーザーに戻ってください。

stoq-server にリモートからアクセスできるようにしたい場合、[[PostgreSQL#リモートホストから PostgreSQL にアクセスできるように設定]]を見てください。

root で {{ic|supervisord.service}} を[[起動]]・[[有効化]]してください。

スーパーバイザープロセスを再起動:

 # supervisorctl update
 # supervisorctl restart stoqserver

==== Stoq-server 設定ファイル ====

stoqserver のメインの設定ファイルは {{ic|/usr/share/stoqserver/.stoq/stoq.conf}} です。

=== シリアル接続 ===

stoqserver はシリアル接続や USB 経由のシリアル接続でコンピュータと通信します。そのためシリアルデバイスファイルを読み書きできる権限が必要です。[[Udev]] によって作成される {{ic|/dev/tts/}} のファイルは所有グループが {{ic|uucp}} となるため、ユーザーを {{ic|uucp}} グループに追加することで読み書き権限を付与できます:

 # gpasswd -a stoqserver uucp

{{Note|変更を適用するには一度ログアウトしてログインしなおす必要があります。}}

== 参照 ==

詳しい情報は Stoq の [https://wiki.stoq.com.br/index.php/Getting_started wiki] や [https://doc.stoq.com.br/manual/latest/ マニュアル] (ポルトガル語) を参照してください。