{"id":22297853,"url":"https://github.com/msyk/imapp_account","last_synced_at":"2025-03-25T22:44:40.488Z","repository":{"id":41976775,"uuid":"460304085","full_name":"msyk/IMApp_Account","owner":"msyk","description":"Accounting Web Application for Japanese Freelance Workers.","archived":false,"fork":false,"pushed_at":"2023-11-23T06:50:01.000Z","size":658,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-30T20:17:04.137Z","etag":null,"topics":["account","inter-mediator","sqlite","webapp"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/msyk.png","metadata":{"files":{"readme":"README-container.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-02-17T06:08:49.000Z","updated_at":"2022-03-27T06:10:27.000Z","dependencies_parsed_at":"2023-02-09T21:45:59.085Z","dependency_job_id":"cda07c72-bc1f-495a-89ab-bc1e7bd6de41","html_url":"https://github.com/msyk/IMApp_Account","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msyk%2FIMApp_Account","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msyk%2FIMApp_Account/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msyk%2FIMApp_Account/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msyk%2FIMApp_Account/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/msyk","download_url":"https://codeload.github.com/msyk/IMApp_Account/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245556960,"owners_count":20634889,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["account","inter-mediator","sqlite","webapp"],"created_at":"2024-12-03T17:51:41.722Z","updated_at":"2025-03-25T22:44:40.465Z","avatar_url":"https://github.com/msyk.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IMApp_Account（IM会計）をコンテナ方式で運用\n\nIM会計をコンテナで運用する場合のセットアップや利用方法について説明します。\nともかく、Dockerでなるべく何もしないで動かしたいという場合と、サーバ上での運用を想定しました。\n前者の場合は、構築にちょっと時間がかかるのでサクっとは行きませんが、コマンド1つで稼働します。\nサーバで本格的な運用をする場合は、少なくとも認証をする必要はあると思われるので、いくらかの改造が必要になります。\n\n新居雅行 (nii@msyk.net)\n\n## 稼働のための手順と稼働結果\n\nDocker Desktopなど、Dockerが稼働する状況で、このレポジトリをクローンして、コンテナ構築のコマンドを入れてください。以下はその例です。\n```\ngit clone https://github.com/msyk/IMApp_Account\ncd IMApp_Account\ndocker compose up -d --build\n```\nPHPのビルドにちょっと時間が係、15分くらいかかると思います。\nこれで、PHPが稼働するUbuntu Serverが「php-apache_im_account」というコンテナで稼働します。\nこのコンテナ内にはPHPをセットアップするとともに、INTER-MediatorやIM会計も全てインストールされた状態になります。\nIM会計自体もコンテナ内部にクローンされています。\n言い換えれば、前述のクローンしたレポジトリのファイルを変更しても、Webアプリケーション側は反映されません。\n\nまた、MySQLにスキーマを適用したデータベースが、「mysql_im_account」というコンテナで稼働します。\nデータベース自体は、前述のクローンしたレポジトリの```/docker/mysql/db```ディレクトリに保存されています。\nデータベースのファイルはコンテナから外出ししてあるので、コンテナ自体を消去しても、データファイルは基本的には残ります。\nただし、データファイルは、```.gitignore```に含まれているので、そのままではレポジトリへは記録されません。\n\n## アプリケーションの開始\n既定値では、php-apache_im_accountコンテナは、8088番ポートを開いています。\n同じMac/PC等のブラウザで「 http://localhost:8088/ 」を開くと、アプリケーションにアクセスできます。\n\n## Setup for S3\n\n続いてAmazonのクラウドサービスAWS内に構築するストレージ「S3」に請求書・納品書・領収書などの関連帳票類を収める仕組みを構築します。\n\nIM会計に必要な情報は、privateディレクトリに ```aws_settings.php``` というファイルを作ってそこに記述します。\nつまり、php-apache_im_accountコンテナの```/var/www/html/private```というディレクトリに ```aws_settings.php``` ファイルを作成します。\nこのファイルにS3のアカウント情報などを保存などを保存します。\nファイル内容の詳細は、```/private```ディレクトリにある```README.md```ファイルを読んでください。\n\nS3側では、IAMサービスでS3のフルアクセス機能を持ったユーザを作っておく必要があります。\nまた、S3には帳票のファイルデータを保存するためのバケットを用意します。\nバケット名は```/private```ディレクトリ内に作る```aws_settings.php```というファイル内で指定する ```$rootBucket``` と同じものを設定してください。\n\nなお、S3のセットアップをしない場合は、ファイルのアップロードはできませんが、会計記録の作業は可能です。\n\n### S3に関して\n\nS3はクラウド上にファイル保存できる仕組みで、税務書類など長期間に渡って参照されることなく保存しておくだけといった利用形態ならきわめて低料金で利用できます。\n青色申告に使った帳票類は７年間、法人の場合は帳票によって10年間の保存義務がありますが、その間ほとんどダウンロードして表示させることはありません。\nこうした利用形態にはうってつけの仕組みです。\n改正電子帳簿保存法ではタイムスタンプの付与などに関して大幅に条件が緩和されましたが、\n緩和の条件としてクラウド上に保存した帳票の追加や訂正などが生じた時にその履歴が記録されるシステムであることという要件が加わりました。\nS3はそうした操作記録がすべて残される上に、訂正する前のファイルも復元してダウンロードできます。\nこれらの機能により、立入り税務調査などの場合にも対応できるシステムを構築できます。\n\n## データベースに対する処理\n\nダイレクトホスト形式の場合には、コマンドでバックアップ等をできるようにしていましたが、コンテナ方式ではそれはサポートされていません。\n独自に、mysqldump等でテキストファイルにSQLダンプを取るなどの仕組みを構築してください。\nまた、コンテナ方式では、スキーマのアップデートには対応しない予定です。\n\n## 「IM会計」アップデートの作業\n\nIMApp_Accountのレポジトリをクローンして運用している場合、php-apache_im_accountコンテナで、```/var/www/html```をカレントディレクトリにして、\n```composer update```コマンドを実行すれば、INTER-Mediatorを含むPHPやJavaScriptのライブラリを更新します。\n\n## 独自のレポジトリでの運用\n\nこのレポジトリはパブリックなので、当然ながらセンシティブな情報はここにはアップロードできません。\nこのレポジトリがプライベートであることで問題が解決するなら、GitHubのテンプレート機能を使ってみましょう。\nプライベートなレポジトリであれば、もしあなたが気にしないのであれば、プライベートな情報を保持できます。\n例えば、データのバックアップや独自のページを追加できます。\n一方、そのようにすると、オリジナルのレポジトリは切り離され、オリジナルのレポジトリへの更新結果を反映させるのは難しくなる点は注意が必要です。\n\n- プライベートなレポジトリを作成するには、このレポジトリのトップページにある「Use this Template」をクリックして、レポジトリを作ります。\n- 作ったレポジトリを、クローンして利用してください。もちろん、変更結果は自由にプッシュして保存しておきます。\n- 作成したファイルなどをレポジトリ側に反映させるために、```.gitignore```ファイルの記述を見直してください。\n\nレポジトリにプライベートな情報を保存するのは安全でしょうか？　\nこの問いへの回答は確かに難しいのですが、少なくとも管理の甘いオンプレミスなサーバよりよほど安全ではないでしょうか。\n\n独自のレポジトリで運用する場合には、次のような変更を手作業で行ってください。\n\n- ```/docker/php-apache/Dockerfile``` に関して、おそらく24行目くらいになりますが、レポジトリをクローンする箇所があります。\n  レポジトリのURLが ```https://github.com/msyk/IMApp_Account``` になっていますが、このURLを自身のレポジトリのURLに変更してください。\n  **この変更は必須です。**\n- S3へ帳票類を保存するために```/private/aws_settings.php```を作成します。\n  そのような追加ファイルを管理するためには、独自レポジトリを運用するのがベストプラクティスです。\n\n## サーバでの運用\n\nサーバでの運用には、いくつか修正が必要です。そのためにも、独自のレポジトリで運用することが求められます。\n\n### MySQLのパスワード\n\nMySQLのデータベース定義は、```/docker-compose.yaml``` ファイルに記述されています。\nそこに、rootのパスワードや、データベース運用のためのパスワードが記載されています。\ndbコンテナのenvironmentの箇所です。\nこれらについては、独自のレポジトリ側でパスワードを書き換えれば良いでしょう。\nデータベース運用ユーザとパスワードについては、```/lib/params.php```と設定を合わせる必要があります。\n\n### 認証機能のアクティベート\n\nサーバで運用するには、各ページで認証が必要です。そのために、定義ファイルの以下の部分のコメントを外します。\n\n```php\n    [\n//        'authentication' =\u003e [\n//            'authexpired' =\u003e '7200',\n//            'storing' =\u003e 'credential',\n//        ],\n    ],\n```\n\nこの記述があるファイルは以下の通りです。\n\n- /index_contexts.php\n- /Master/master_contexts.php\n- /Print/invoice.php\n- /Summary/contexts.php\n- /Summary/editlog.php\n\n初期データベースには、 ユーザ名「account」、パスワード「Leyc291#B」というユーザが登録されているので、そのユーザでログインができるはずです。\nもちろん、運用時には即座にパスワードは変更してください。\n\n最初にそのユーザでログインできれば、パスワードの変更も可能です。\nユーザが一人ならそれでもいいのですが、数人分のアカウントを発行するには、ユーザ管理ページが欲しいところです。\nそのサンプルは、INTER-Mediatorの/samples/Auth_Supportにありますので、そちらを参考にして構築してください。\n\n## 謝辞\n\n- haya-san ドキュメントの監修ありがとうございます。","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsyk%2Fimapp_account","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsyk%2Fimapp_account","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsyk%2Fimapp_account/lists"}