muku-core
飲食店のレジのジャーナルを読んで、月の数字を分解し、Excelのワークブックにまとめます。
これは 「ムク」という商品の計算部分 です。単体では動きますが、単体では商品になりません。 ムクの本体は、数字をどう読んで何を問いかけるかを決めている憲章のほうで、そちらは 使用権をお持ちの方にお渡ししています。
できること
レジのジャーナルCSVを渡すと、正規化した3つの表（取引・明細・割引）に揃えて、 そこから18枚のタブを持つExcelのワークブックを作ります。
- 売上の分解（店内・テイクアウト・物販。レジが2台以上でも1冊にまとまります）
- 客数・客単価・組数・組単価・組人数
- 曜日別・時間帯別（チャネルで絞れます）
- 滞在時間・卓占有率
- カテゴリ別・商品ABC分析（原価を渡せば粗利率まで）
- 割引と返品
- 予算根拠（前年実績で埋めてあります）
- 検算（合計が合っているか、何が取れていないか）
取れないものは空欄にします。推定で埋めません。 レジによって取れるものが違うので、ワークブックの設定タブに 「このお店のレジから読めるもの」の一覧が出ます。
対応しているレジ
| ジャーナル | 客数 | 原価 | 割引 | |
|---|---|---|---|---|
| Airレジ | ○ | ×（Airメイトから） | ○ | ○ |
| Airメイト | — | ○（会計数） | △ | × |
| MDでん票くん | ○（画面のコピーから） | ○（人数） | ○ | × |
でん票くんは明細のCSV出力を持たないレジですが、日報のXLSXと伝票画面のコピーから 同じ精度で読めます。
使い方
ふだんはClaudeが呼び出すので、直接触る必要はありません。
from v1core import airregi
from v1core.storeconfig import load
from v1core.workbook import build_workbook
config = load("store_config.json")
t = airregi.convert(["ジャーナル履歴_20260601-20260831.csv"], config=config)
build_workbook(t["txn"], t["lines"], t["discounts"], config,
daily=daily, target_ym="2026-08", out_path="ワークブック_202608.xlsx")
レジが2台以上ある店は v1core.multi.load(config) を使います。
使用許諾
オープンソースではありません。
- **ご自身のお店の分析に使うのは自由です。**台数も回数も制限しません
- 第三者の店舗の分析を業として請け負う場合は、別途の使用権が要ります。 コンサルティング・分析代行・自社サービスへの組み込み・研修教材としての利用が該当します
- 複製の配布、改変版の公開は禁じています
コードが公開されていることと、自由に使えることは別です。
全文は同梱の LICENSE.txt をご覧ください。
人の店で商売に使いたい方は、一度ご連絡ください。断るためではなく、 一緒にやれることがあるかもしれないので。
連絡先
t.watabe@mssbworks.com 株式会社ムササビ（mssbworks）
1 maintainer
Release files for muku-core 1.20260912.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| muku_core-1.20260912.1.tar.gz | 131.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| muku_core-1.20260912.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 277.7 kB
Release files / muku_core-1.20260912.1.tar.gz
| Download URL | muku_core-1.20260912.1.tar.gz |
|---|---|
| Size | 131.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
53d295e5bbdbcbf12e3539ea954b11d4728c8bf041735b872a0d71b58f624218
|
|
BLAKE2b-256 checksum How to use checksums |
1c74a4da11956352a7f7749e854c829bea7bfa9b86d91f2d7b21736727879d21
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / muku_core-1.20260912.1-py3-none-any.whl
| Download URL | muku_core-1.20260912.1-py3-none-any.whl |
|---|---|
| Size | 146.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bdbf1ddfd59ccabe365445d31e6f08c0626058ac9be571038a5bd9408b51117c
|
|
BLAKE2b-256 checksum How to use checksums |
08599dd3f552a2b87635eba8997415baa971ecaaee7cd2577a2bb1b0b6542815
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
