よくある質問

コレクションを預ける前に、聞いておく価値のあることすべて。

10 個のテーマにわたる 102 件の回答です。所有権、プライバシー、料金、セルフホスト、そして KolleK にできることの正直な限界。

10 秒でわかる要点

ほとんどの人が最初に尋ねる質問。

KolleK は本当にオープンソースですか?

はい、MIT ライセンス

アプリケーション全体が GitHub にあります。読む、フォークする、自分で動かす、すべて自由です。

セルフホストは無料ですか?

ずっと無料

当方でのアカウント登録もライセンスキーも有料プランもありません。

データは自分のものですか?

あなたのものです

入力したものの所有権はすべてあなたに残ります。

コレクションは非公開ですか?

アカウント内のみ

公開リンクはまだ存在しないため、何もアカウントの外には出ません。

サブスクリプションはありますか?

いいえ、一度きりの支払い

セルフホスティングは無料です。ホスティング版のアカウントは一度解除するだけで、貸し出しではありません。

データをエクスポートできますか?

一部のみ可能

タイプ定義と貸出中の記録だけです。アイテムのエクスポートはまだありません。

他の人を招待できますか?

はい、人数課金なし

オーナー・編集者・閲覧者の役割が、書き込みのたびに適用されます。

KolleK を使わなくなったらどうなりますか?

そのまま動き続けます

セルフホストのインスタンスは、当方から何も受け取らなくても動きます。

データはどこにホストされますか?

置いた場所に

あなた自身のサーバー、または利用する場合は当方のホスティング基盤です。

鑑定・査定のソフトウェアですか?

いいえ

入力された価値を記録するだけで、価値を決めることはありません。

この検索に一致するものはありません。

「エクスポート」「バックアップ」「API」のように、短い言葉で試してみてください。答えが本当に見当たらない場合は、教えていただければここに追加します。

質問する
01

製品の基本

10 件の質問

KolleK とは何か、誰のためのものか、そしてこのページで使う言葉について。

KolleK はコレクションを目録化するためのオープンソースのアプリケーションです。所有しているものをアイテム単位、そして実物のコピー単位で、写真・書類・価値・履歴とともに記録できます。自分のサーバーで動かすことも、誰かが運用しているインスタンスを使うこともできます。MIT ライセンスで公開されています。

まず、表計算ソフトでは手に負えなくなった個人のコレクターです。1 つのアカウントに複数の人を異なる役割で迎えられるので、家庭・同好会・小規模な団体でも使えます。機関向けの収蔵品管理システムではありませんし、そうなろうともしていません。

どんな種類でも管理できます。新しいアカウントには、すぐ使える 12 のコレクションタイプ(コミック、トレーディングカード、レコード、CD、DVD、コイン、切手、書籍、フィギュア、ビデオゲーム、腕時計、ワイン)が用意されており、どれでも編集でき、ゼロから自作することもできます。

できます。数を制限するコードはどこにもありません。コレクションごとに名前、絵文字、説明、通貨、そして独自のカテゴリーとセットを持てます。

アイテムは抽象的な「もの」です。タイトル、型番、版などを指します。コピーは実際に所有している 1 点の実物で、それぞれに状態、保管場所、購入価格、履歴があります。同じコミックを 3 冊持っているなら、1 つのアイテムと 3 つのコピーです。KolleK でもっとも大切な考え方です。

使えます。アイテムは名前と写真だけでもよいですし、カスタム項目、複数のコピー、評価額、保険、貸出、メンテナンス、来歴、添付書類まで備えた記録にもできます。定義しなかった項目は決して表示されません。

はい、7 言語です。英語、フランス語、スペイン語、ドイツ語、ブラジルポルトガル語、簡体字中国語、日本語。各自が自分の言語を選べ、ドキュメントとこの公開サイトも翻訳されています。

ありません。iOS や Android のネイティブアプリは存在せず、コードの中にもありません。KolleK はブラウザーで開くウェブアプリケーションです。

使えます。すべての画面がスマートフォンの幅まで対応しており、写真の追加は端末の通常のファイル選択画面を使うので、スマートフォンならカメラも選べます。

はい、MIT ライセンスで、アプリケーションのソースコード全体が GitHub で公開されています。すでに公開されたコードについて、このライセンスが取り消されることはありません。

KolleK を動かす 2 つの方法と、それぞれでデータがどうなるか。

できます。むしろそれが主に想定された動かし方です。Docker Compose の構成がウェブサーバー、キューワーカー、スケジューラー、データベースを起動し、セルフホスト版で機能が削られることはありません。

ソフトウェアも機能も同じです。プランの後ろに閉じ込められた機能はなく、セルフホスト版から削られた機能もありません。違うのは、サーバーを運用し、更新を適用し、バックアップを保管するのが誰かという点と、ホスティング版のアカウントは解除するまで 10 件まで無料という点だけです。セルフホスト環境にはこの上限はありません。

小さな Docker 構成の運用に抵抗がなく、バックアップの責任を負えるなら、セルフホストです。無料で、データが自分のマシンから出ることもありません。何も運用したくないなら、ホストされたインスタンスを使ってください。

はい。追加したものの所有権はすべてあなたに残り、利用規約にもそう書かれています。ホスティングサービスでは、サービスを提供するためだけに保存・処理しており、それ以外の用途はなく、学習に使うこともありません。

一部だけ可能で、これは現時点で正直に認めている弱点です。コレクションタイプの定義を JSON で、貸出中の一覧を CSV でエクスポートできます。アイテム単位やコレクション全体のエクスポートはまだありません。セルフホストしている場合の完全な答えは、すべてが入っているデータベースとストレージボリュームのバックアップです。

アプリからはまだできません。アイテムのエクスポートが存在しないためです。それまでは、ホスト版インスタンスの運用者にデータベースとファイルのダンプを依頼し、自分のインストール環境に復元することになります。

逆方向でも答えは同じで、アイテムの取り込み経路はまだありません。2 つのインスタンスを統合できるのは、運用者がデータベースの層で行う場合だけです。

セルフホストのインスタンスはそのままの状態で動き続けます。どこかに接続を返すこともライセンスを確認することもなく、MIT ライセンスにより誰もコードを取り上げられません。ホストされたインスタンスなら、アカウントとその中身をいつでも削除できます。

Laravel Cloud 上で動き、データベースは Turso、前段の DNS・キャッシュ・防御は Cloudflare です。これらの事業者の構成により、あなたの情報が居住国以外で処理される場合があり、現時点でリージョンの選択肢は提供していません。

アプリケーションは Laravel Cloud、データベースは Turso、DNS・ルーティング・TLS・不正対策は Cloudflare です。いずれもインフラ事業者として当方に代わってデータを処理しており、プライバシーポリシーに名前を明記しています。

03

料金とプラン

10 件の質問

ソフトウェアの価格と、正直にまだ作られていないもの。

セルフホスティングは無料で、費用は自分のサーバー代だけです。ホスティング版ではアカウントごとに 10 件まで無料、恒久的な解除は 49 ドルの一度きりの支払いです。決済はまだ開いていないため今日は購入できませんが、上限を説明する画面はすでにアプリに入っています。

いいえ、その仕組み自体がありません。KolleK には定期的にカードへ請求する機能は一切ありません。約束するのは、アカウントを恒久的に解除する一度きりの支払いであって、レンタルではありません。

ホスティング版アカウントのアイテム上限を解除し、サーバー、更新、バックアップ、サポートという運用面の費用にあてられます。機能の解除ではありません。どの動かし方でも、すべての機能はすでにアプリに入っています。

本当に無料です。試用期間も機能制限版も、購入すべきライセンスキーもありません。公開済みのコードに付いた MIT ライセンスを後から撤回することはできません。

セルフホスト環境に上限は一切ありません。ホスティング版で唯一の上限はアイテム数です。アカウントごとに 10 件まで無料、猶予としてさらに 5 件まで受け付け、その後は解除するまで新規追加を停止します。すでに追加済みのものが削除されたり、非表示になったり、読み取り専用になることはありません。コレクション、メンバー、写真、書類はどちらの場合も数に含まれません。残る制限はファイル単位(写真は 10 MB、書類は 12 MB)と、インスタンスに割り当てたディスク容量だけです。

いいえ。小さな文字ではなく、支払う前にお伝えします。取消が起きると、この規模のプロジェクトには決済手数料とチャージバックの違約金、そして半日分の事務作業がのしかかります。何か問題があればメールをください、必ず対応します。まったく支払いたくない場合、セルフホスティングは無料で、これからもずっと無料です。

今後の購入については変わる可能性があります。利用規約では、完了済みの買い切り購入がさかのぼって値上げされることも、サブスクリプションに変わることもないと定めています。

不要です。セルフホストに当方でのアカウント作成も、登録手続きも、支払いの段階もありません。リポジトリをクローンするかイメージを取得して、動かすだけです。

ホスティングプランを販売する際は、付加価値税や売上税は所在地によって決まり、利用規約のとおり支払い前に表示されます。

人数課金も別プランもないので、一世帯でも 30 人の団体でも同じ金額になります。請求書や調達用の書類が必要な場合はご連絡ください。

何が守られ、鍵を誰が持ち、どこで保護が終わるのか。

記録した内容がアカウントの外から見えることはありません。公開リンクも、外部から見つかる仕組みもありません。ただしアカウント内では、現時点でどのメンバーもすべてのコレクションを閲覧できます。コレクションごとの公開範囲の設定は保存されますが、まだ適用されていません。

していません。プライバシーポリシーに明記しており、それを必要とするような広告モデルもここにはありません。

していません。アプリケーションに広告トラッカー、第三者の分析、トラッキングピクセルはありません。サービスの運用と不具合調査のために、運用ログ(リクエスト、エラー、セキュリティイベント)は保持しています。

はい。名前、説明、識別子、メモは、データベースに届く前にインスタンスの鍵でアプリケーションが暗号化し、通信は TLS で行われます。エンドツーエンド暗号化ではありません。インスタンスを運用する者が鍵を持ち、データを読むことができます。

セルフホストならあなたです。鍵はあなた自身の環境ファイルにある APP_KEY で、他の誰も目にしません。ホスティングサービスではアプリケーションの鍵を当方が保持し、インフラ事業者には渡していません。

各社は当方に代わって動くインフラ事業者として、データを保存・転送するシステムを運用しています。アプリケーションの暗号鍵は渡しておらず、あなたのコレクションを各社の目的に使う権利もありません。

DNS、TLS 終端、キャッシュ、そしてサービス妨害などの濫用への防御のためです。大きなインフラ部隊を抱えずに、小さなプロダクトを速く、つながる状態に保てます。

リカバリーコード付きの二要素認証、パスワード不要のマジックリンクによるログイン、既知の漏洩リストと照合するパスワード検査、重要な出来事(新しい端末、新しい IP アドレス、ログイン失敗、API キーの作成や失効)を知らせるメール、書き込みのたびに適用される役割ベースの権限、いつでも失効できる API キー、そして誰が何を変更したかの監査履歴です。シングルサインオン、ハードウェアキー、アクティブなセッションを管理する画面はありません。

対応しています。一般的な認証アプリを利用でき、有効化時に一度だけ使えるリカバリーコードも発行されます。

重要なフィールドは書き込み前にアプリケーションが暗号化するため、あなた自身のものを含め、どのデータベースダンプの中でも暗号化されたままです。それ以外について、ホスト側のバックアップは運用復旧のためだけに存在し、セルフホストのバックアップはあなたが施した対策の分だけ守られます。

公開の Issue ではなく、メンテナーへメールで非公開に報告してください。何よりも先に確認します。バグ報奨金制度はなく、正式な開示スケジュールをお約束することもできません。

できます。自分のユーザーはプロフィールから削除でき、オーナーはアカウント全体を中身ごと削除できます。長期間使われていないユーザーを自動的に削除する設定もあります。削除はバックアップの通常のローテーションに従って、そこからも消えていきます。

何を入れられ、何を取り出せて、保管の責任が誰にあるのか。

コレクション、アイテム、所有しているコピー、写真、書類、カテゴリー、タグ、保管場所、状態、セット、シリーズ、そして各コピーに紐づく取引、評価額、保険記録、貸出、メンテナンス記録、来歴の出来事、保管場所の履歴です。

できます。1 つのアイテムに複数枚、好きな順序で登録でき、1 枚をメインに指定できます。アップロードのたびに閲覧用の小さいサイズが生成され、1 枚あたり 10 MB まで対応します。アカウントには、すべての画像を一覧できるフォトライブラリもあります。

できます。書類はコピー、またはその記録(取引、評価額、保険記録、貸出、メンテナンス記録、来歴の出来事)に添付します。PDF、画像、Word や Excel のファイル、CSV、テキストを 12 MB まで受け付け、外部 URL にある書類を登録することもできます。

できます。評価額は 1 つの数字ではなく履歴として残り、それぞれに種類と確度が付くので、コピーの価値の移り変わりが分かります。購入と売却は取引、保険は証券の詳細を持つ独立した記録で、書類はそのいずれにも添付できます。

まだできません。エクスポートはコレクションタイプの定義(JSON)と貸出中の一覧(CSV)に限られます。アイテムやコレクション全体のエクスポートは既知の不足で、ドキュメントの機能ステータスのページで追跡しています。

取り込めるのはコレクションタイプの定義だけで、エクスポートが出力した JSON を使います。アイテムの表計算や CSV からの取り込みはないため、現時点ではコレクションは手入力するか API から登録します。

ホスティングサービスでは運用復旧のためのバックアップを保持しています。サービスを復旧させるためのもので、利用者が自分で戻す仕組みではなく、あなた自身の記録の代わりにもなりません。

含まれます。追加購入は不要です。ただしインスタンス全体の運用バックアップであり、アカウントごとに閲覧できるスナップショットではありません。

すべてあなたにあります。データはデータベースのボリュームと、写真や書類が入るストレージのボリュームの 2 か所にあります。すでに信頼している方法で両方をバックアップし、APP_KEY の控えも保管してください。鍵がなければ暗号化されたデータは読めません。

コレクション、アイテム、コピー、カテゴリー、セットはごみ箱に入り、既定では 30 日間復元できます。その後は毎日のジョブが完全に削除します。写真、書類、履歴の記録はすぐに削除され、アプリの中からは復元できません。

できます。ごみ箱を空にすればその中身は即座に消え、アカウントを削除すればそれに属するものはすべて消えます。

06

機能

11 件の質問

最初のコレクションを作ったあと、このアプリケーションが実際にできること。

作れます。タイプはその種類のコレクションが何を持つかを定義し、それを使うすべてのコレクションが項目を引き継ぎます。新しいアカウントに付属するものを編集しても、自作しても構いませんし、定義を JSON で書き出して別の場所で再利用できます。

できます。種類は 6 つで、テキスト、数値、日付、はい/いいえ、自分で作る選択肢のリスト、5 段階の評価です。項目は名前付きのグループにまとめられるので長いフォームでも読みやすく、項目もグループも並べ替えられます。

5 つすべて使えて、それぞれ独立しています。カテゴリーはコレクションの中で入れ子にでき、保管場所は好きなだけ深く入れ子にでき(部屋の中の箱の中の棚)、タグはアカウント全体で共有され、セットは目標数に対する達成度を追い、シリーズはひとまとまりのアイテムをまとめます。

できます。アイテムとコピーを分けている理由がまさにそれです。各コピーが独自の識別子、状態、保管場所、取得日、購入価格、履歴を持ちます。

できます。貸したものと借りたもの、両方向に対応します。相手、日付、返却期限、持ち出し時と返却時の状態を記録でき、それぞれの方向の未返却分を CSV でダウンロードできます。

残せます。来歴の出来事はコピー上で日付順の連なりになり、それぞれに種類、関係者、説明、添付した書類が付きます。

できます。メンテナンス記録には作業の種類、日付、費用、実施者、そして受け取った書類が残ります。

できます。評価額はコピーの価値の推移と、その数字の出どころを記録します。取引は支払った額や受け取った額、日付、相手を記録します。金額はコレクションの通貨で保存されます。

できます。写真はアイテム上で管理でき、アップロードしたすべての画像はアカウント全体のライブラリでも確認できます。書類はそれが属するコピーや記録の上で管理し、いずれも検索に表示されます。

できます。1 回の検索でアイテム、コピー、コレクション、写真、貸出、保管場所、セット、シリーズ、カテゴリー、タグ、書類を横断し、結果は種類ごとにまとまります。元の文字列が暗号化されていても機能するのは、語をそのまま保存せずハッシュとして索引しているからです。

見られます。コレクション単位で、合計、価値の推移、月ごとの取得数、カテゴリー・状態・保管場所ごとの内訳、価値の高いアイテム、セットの達成状況が分かります。アカウント全体をまとめた画面はまだなく、ダッシュボードでは代わりに最近の動きを表示します。

アカウント全体を明け渡さずに、他の人を迎え入れる。

できます。オーナーがメールで招待し、その時点で役割を選びます。招待はリンクから受け取り、メンバーごとの料金はかかりません。

3 つです。オーナー、編集者、閲覧者。オーナーはメンバー、設定、削除を扱い、編集者は記録を作成・変更し、閲覧者は読むだけです。アカウントには必ず 1 人以上のオーナーが残るため、最後の 1 人は削除も降格もできません。

扱えます。アカウント内の全員が同じコレクションを扱い、操作はすべて実行者とともに記録されるため、アクティビティとアイテムの履歴から変更の出どころが分かります。

まだできません。コレクションには公開範囲の設定があり保存もされますが、それを適用する仕組みがなく、公開リンクもありません。公開に設定してもアカウントの外からはまったく到達できません。

同じアカウントの他のメンバーに対してはできません。理由は同じで、公開範囲は保存されるだけで現時点では適用されないからです。招待した人はアカウント内のすべてのコレクションを見られるので、本当に分けたいものは当面別のアカウントに置いてください。

外せます。オーナーが即座に外せ、その時点でアクセスは終わります。その人が記録した内容はアカウントに残ります。

使えます。アカウントと役割はまさにそのためのものです。1 つだけ想定しておくべき点として、1 人は 1 つのアカウントにのみ所属し、1 つのメールアドレスに 1 ユーザーしか作れません。同好会のアカウントに参加しつつ個人用を持つことはできません。

アプリにはサポートの画面があり、そこでスレッドを開いて返信を受け取れます。インスタンスの運用者が有効にしない限り無効なので、セルフホストのインスタンスでは通常は表示されません。

自分のインスタンスを動かす。必要なもの、更新の方法、責任の所在。

Compose プラグイン付きの Docker Engine 24 以降と、写真や書類のためのディスク容量です。小さな VPS や自宅のマシンで十分です。この構成がウェブサーバー、キューワーカー、スケジューラー、MySQL を起動します。

対応しており、推奨の方法です。サンプルの環境ファイルをコピーし、アプリケーションキーを生成して、構成を起動してください。詳しい手順はリポジトリと、ドキュメントのセルフホストの章にあります。

動かせます。ごく普通の Laravel アプリケーションなので、PHP 8.4 と通常の拡張、データベース、ウェブサーバー、キューワーカー、スケジューラーがあれば動きます。ただし、手順が整った Docker の道に比べると当方から提供できる助けは少なくなります。

MySQL 8 で、Docker の構成が用意します。ローカル開発では SQLite でも動き、Laravel が対応する他のデータベースでも動く可能性はありますが、テストとドキュメントの前提は MySQL です。

新しいイメージを取得して構成を再起動します。マイグレーションは起動時に実行され、既存のデータベース上でも安全なように書かれているので、更新でデータやアップロードが初期化されることはありません。

あなたが用意します。データベースのボリュームとストレージのボリュームをバックアップし、APP_KEY を安全な場所に保管し、ときどき復元を試してください。自分のインスタンスでは、バックアップは自動では何も行われません。

使えます。写真と書類は既定でローカルのボリュームに保存され、FILESYSTEM_DISK を S3 互換のバケットに向ければそちらに移せます。ファイルは公開 URL ではなく、常にアカウントを確認するルート経由で配信されます。

使えます。環境ファイルのメール設定から、任意の SMTP サーバー、または Resend を指定できます。既定ではメールはログファイルに書き出されるので、誰かを招待する前に設定してください。

MIT ライセンスなので、どんな変更も自由です。現実的な注意点として、大きく改変したインスタンスは更新が難しくなるため、有用な変更は本家に還元するほうが結局は得になります。

GitHub の Issue と Discussions を通じたコミュニティのサポートです。購入できる有償サポート契約はありません。それが、自分で動かす場合と誰かに動かしてもらう場合の正直な違いです。

09

API と開発者向け

10 件の質問

プログラムからの利用と、手伝いたい場合の方法。

あります。ウェブアプリケーションと同じ操作・同じ規則を映した JSON API で、エンドポイントはおよそ 150 個、リファレンスは各インスタンスの /docs/api で公開されています。

個人アクセストークンを、HTTPS 上で Authorization ヘッダーに Bearer トークンとして送ります。ログインのエンドポイントで、メールアドレスとパスワードをトークンと交換することもできます。

できます。プロフィールの設定から作成でき、1 つずつ失効させられます。キーはあなたの役割とまったく同じ権限を持ち、現時点でスコープや有効期限はありません。キーの作成時と削除時にはメールが届きます。

コレクションとそのタイプ、カスタム項目とグループ、アイテム、コピー、写真、タグ、カテゴリー、セット、シリーズ、保管場所、状態、書類、取引、評価額、保険、メンテナンス、来歴、保管場所の履歴、貸出、ごみ箱、検索、統計、メンバー、招待です。役割に応じて読み取りも書き込みもできます。

あります。認証後は 1 分あたり 60 リクエスト、ログインと登録は総当たりを鈍らせるため 1 分あたり 6 リクエストです。

半分だけ対応していて、どちらの半分かを知っておく価値があります。エンドポイントを登録でき、それぞれに署名用の秘密鍵が発行されますが、Webhook を発火させるアプリケーション側のイベントはまだありません。配信の仕組みは用意済みで、イベントが接続されるのを待っています。

作れます。画面でできることは API でもできるので、スクリプトで目録を取り込むことも、定期的に書き出すことも、今日から十分可能です。

リポジトリの中でコードのすぐ隣に書かれ、/docs/api で読むリファレンスとして描画されます。各セクションには Markdown 版もあります。ドキュメントのないエンドポイントがあるとテストがビルドを失敗させ、それが両者のずれを防いでいます。

ぜひお願いします。不具合の報告、機能の提案、翻訳、ドキュメント、プルリクエスト、いずれも歓迎です。「good first issue」のラベルが付いた Issue は取りかかりやすい入口です。

プロジェクトの GitHub Issue へ、不具合というより相談に近い内容なら Discussions へお願いします。セキュリティの問題だけは例外で、非公開のメールでお送りください。

10

信頼と限界

10 件の質問

KolleK があえてやらないこと。頼りにする前に読む価値があります。

しません。あなたが伝えたことを記録するだけです。本物かどうかを確かめる手段はなく、できるふりもしません。

違います。あなたや専門家が入力した評価額を、その数字がどれだけ確かかという情報とともに保存します。市場価格を調べることも、独自に価値を算出することもありません。

しません。これは記録のための道具であり、利用規約にもそう書かれています。補償、税、売却の判断は、それぞれの専門家に相談してください。

できません。領収書、写真、来歴をきちんと残した記録は補強材料としては有用ですが、権利を証明するものではありません。アカウントにアクセスできる人は何でも書き込めます。

個人のコレクターや小さな集まりであれば、なることが多いでしょう。収蔵登録の基準、保存修復の手順、法定の報告が求められる場面では代わりにならず、当てにすべきではありません。

誤りも含めて、そのまま保存されます。アイテムごとに何が変わり誰が変えたかの履歴が残るので、誤りを見つけて直せます。

正直な一覧です。アイテムやコレクションのエクスポートとインポートがないこと、コレクションごとの公開範囲が保存されるだけで適用されないこと、Webhook が発火しないこと、ネイティブのモバイルアプリがないこと、シングルサインオンやセッション管理がないこと、統計がアカウント全体ではなくコレクション単位であること、そして 1 人につき 1 アカウントであることです。ドキュメントの機能ステータスのページが、この一覧を最新に保っています。

日付入りのロードマップは意図的に用意していません。GitHub の未解決 Issue が進行中の作業を示し、ドキュメントの機能ステータスのページが、完成しているものとそうでないものを説明します。

インスタンスでアプリ内サポートが有効になっている場合は、その画面から連絡してください。それ以外は GitHub の Issue と Discussions が窓口で、1 人がすべてに目を通しています。

公開の Issue を立てずに、メンテナーへ非公開でメールしてください。公表される前に修正できます。善意の報告は歓迎で、何よりも先に対応します。

まだ答えの見つからない質問がありますか?

公開の場で尋ねてもらえれば、その答えは次の人の役にも立ちます。チケットの待ち行列も、チャットボットも、営業の追いかけもありません。