読み込み中
豆知識
バックエンドの主要な業務ロジックを、ドメインごとにまとめた地図です。「この処理はどのエンドポイントが入口で、どのテーブルに着地するか」を一望できます。
書類と添付ファイルは多対多の関係です。ファイルアップロード後、AI が中身を読み取り、書類オブジェクトを下書きします。
flowchart LR
upload[POST /api/file-uploads<br/>multipart] --> stored[(Supabase Storage)]
stored --> ocr[OCR / AI 抽出]
ocr --> draft[POST /api/documents<br/>下書き作成]
draft --> link[POST /api/documents/:id/links<br/>銀行取引と紐付け]
draft --> lock[PATCH /api/documents/:id/lock<br/>電帳法ロック]
link --> journal[自動仕訳生成]
| エンドポイント | 担当 |
|---|---|
POST /api/file-uploads |
ファイル単一・複数アップロード、ハッシュ計算、署名 URL 発行 |
GET /api/documents |
書類一覧、pageSize / pageNumber ページネーション |
POST /api/documents |
書類の新規作成 (確定済み・下書きの両方) |
PATCH /api/documents/:id |
書類の更新 (ロック状態に応じて部分更新を制御) |
POST /api/documents/:id/links |
銀行取引や経費との N:M リンク作成 |
POST /api/ebook/lock |
電子帳簿保存法のロック (改ざん検知用ハッシュ封入) |
POST /api/expense-wizard/draft |
出張・経費の AI ウィザードで束ね生成 |
詳細仕様: 自動仕訳生成・書類リンク・電子帳簿保存法 対応
flowchart LR
fetch[GET /api/bank-statements<br/>同期 + 表示] --> ai[POST /api/ai-reconciliation<br/>AI 仕訳マッチング]
ai --> match[POST /api/reconciliation/links<br/>取引と仕訳の紐付け]
match --> auto[自動消込仕訳生成]
| エンドポイント | 担当 |
|---|---|
GET /api/bank-statements |
銀行明細の取得・並び替え (sort_by, sort_order) |
POST /api/bank-integrations/connections/:connection_id/sync |
銀行連携の同期トリガ |
POST /api/ai-reconciliation |
AI による仕訳・取引マッチング推論 |
POST /api/reconciliation/links |
取引と仕訳のリンク・解除 |
複式簿記の不変条件は API レベルとデータベーストリガの両方で守られています。
| エンドポイント | 担当 |
|---|---|
GET /api/accounts |
勘定科目マスタ (J-GAAP 標準勘定科目を含む) |
POST /api/journal-entries |
仕訳エントリ作成 (借方・貸方バランスチェック) |
POST /api/journal-entries/bulk |
一括作成 (冪等キー対応) |
GET /api/journal-templates |
テンプレート一覧 |
POST /api/accounting/dock-summary |
仕訳ドック用の合計サマリ |
詳細仕様: 仕訳ロジック
確定申告 (個人事業主) と法人税申告の両方をサポートします。e-Tax / eLTAX の電子申告フォーマット (XTX / XML) も生成できます。
| エンドポイント | 担当 |
|---|---|
GET /api/tax-compliance-init |
確定申告画面の初期データ (1 リクエストで全タブ分) |
POST /api/tax-filing/save |
申告書のドラフト保存 (フィルング・セッション) |
POST /api/filing-workspace/export |
XTX / XML エクスポート (有料機能) |
POST /api/filing-amendment/start |
修正申告の手順開始 |
GET /api/filing-amendment/context |
修正申告の出どころコンテキスト（読取専用） |
POST /api/filing-amendment/penalty-estimate |
延滞税・加算税の試算（読取専用） |
POST /api/compliance/etax/import-preview |
外部 XTX/XML プレビュー（DB 書込なし） |
POST /api/compliance/etax/import-xtx/apply |
提出済み基準を不変スナップショットとして保存 |
POST /api/compliance/etax/compare |
取込フィールド vs 帳簿の項目比較 |
POST /api/filing-carry-forward/apply |
前期繰越処理 |
POST /api/year-end-adjustment/run |
年末調整一括処理 |
GET /api/integrity-checks |
整合性チェックの実行履歴 |
詳細仕様: 税務 API・日本会計・提出準備・外部提出ファイルの取込
申告前の XTX/XML 下書きを保存・比較するワークスペースです（提出済み基準の取込とは別用途）。
flowchart LR
import[POST /filing-workspace/files/import] --> store[(workspace_files)]
store --> compare[POST /filing-workspace/compare]
compare --> diff[項目差分]
| エンドポイント | 担当 |
|---|---|
GET /api/filing-workspace/files |
年度別ファイル一覧 |
POST /api/filing-workspace/files/import |
下書き XTX/XML 取込（10MB 上限） |
POST /api/filing-workspace/compare |
ワークスペースファイル vs SBC 計算値 |
flowchart LR
cip[建設仮勘定で登録] --> inservice[POST /fixed-assets/:id/in-service]
inservice --> je[振替仕訳 DR 固定資産 / CR 147]
je --> sched[POST /depreciation-schedule]
sched --> rows[(年度別償却行)]
| エンドポイント | 担当 |
|---|---|
GET /api/fixed-assets/:id/depreciation-schedule |
多年度償却スケジュール |
POST /api/fixed-assets/:id/in-service |
事業供用 + 振替仕訳 |
詳細: 固定資産管理
AI 機能は OpenAI / Anthropic / Gemini を プロバイダー切り替え可能 な形で抽象化しています。会社ごとに月次の予算上限を設定し、超過時はソフトな失敗 (フォールバック・キュー) で守ります。
| エンドポイント | 担当 |
|---|---|
POST /api/ai/analyze |
書類画像・PDF からの汎用抽出 |
POST /api/ai-business-support |
事業計画・経理相談などの自由会話 |
GET /api/ai/models |
利用可能なモデル一覧 |
GET /api/ai/preferences |
ユーザーごとのモデル選好 |
POST /api/advisor/chat |
AI Advisor (Cursor for accountants) のメッセージ送信 |
GET /api/insights |
プロアクティブインサイトの取得 |
詳細仕様: AI アドバイザー構想
flowchart LR
action[ユーザー操作] --> xp[POST /api/gamification/xp]
xp --> level[レベル判定]
level --> achievement[実績解除]
achievement --> notify[通知トリガ]
level --> entitlement[エンタイトルメント<br/>更新]
| エンドポイント | 担当 |
|---|---|
GET /api/gamification |
XP・レベル・実績・連続記録のサマリ |
POST /api/gamification/xp |
XP イベント加算 |
GET /api/entitlements |
エンタイトルメント (有料機能ゲート) 確認 |
POST /api/admin/grants |
管理者用の機能付与 |
詳細仕様: ゲーミフィケーション・ゲーミフィケーション API・サブスクリプション / 収益モデル
LP から呼び出せるデモエンドポイントです。会員登録なしで AI 仕訳分類などが試せます。
| エンドポイント | 担当 |
|---|---|
GET /api/public/demo/stats |
LP 用の集計統計 (公開可能な範囲のサンプル値) |
POST /api/public/demo/classify-journal |
銀行明細1行から仕訳の下書きを生成 (AI / ルール照合) |
POST /api/public/demo/parse-receipt |
領収書画像 / PDF を OCR して構造化 |
POST /api/public/demo/estimate-tax |
法人税・消費税・住民税の簡易試算 |
POST /api/public/demo/provision |
LPデモ会社 を挿入し、共有の読み取り専用トークンを返す（初回ログイン時に自動ではない） |
これらは IP 単位のレート制限と AI 利用バジェットの下で動きます。provision 以外は入力データを保存しません。本番連携を検討している場合は別途ご相談ください。
| エンドポイント | 担当 |
|---|---|
POST /api/data/export |
汎用 CSV / Excel エクスポート |
POST /api/filing-workspace/xtx |
e-Tax XTX 形式のファイル生成 |
POST /api/filing-workspace/xml |
eLTAX XML 形式のファイル生成 |
GET /api/reports/balance-sheet |
貸借対照表 |
GET /api/reports/profit-loss |
損益計算書 |
GET /api/reports/cash-flow |
キャッシュフロー計算書 |
GET /api/reports/trial-balance |
試算表 |
GET /api/reports/general-ledger |
総勘定元帳 |
詳細は 運用ドキュメント を見てください。主なジョブ:
api/cron/integrity-check)読み込み中
豆知識