This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

弥生販売・会計上位互換WebApp

本プロジェクトは、弥生販売と弥生会計の完全上位互換を目指した、本格的なWebApp販売管理システムです。

📋 プロジェクト概要

目的

• 個人事業主や小規模店舗向けに、弥生販売・会計の上位互換となる包括的な販売管理システムを提供する
• 現在広く普及している弥生形式CSVファイルとの相互運用性を実現する

ゴール

• Phase 1: 弥生形式CSVの完全なインポート/エクスポート機能を実装し、既存データとの互換性を確保する
• Phase 2: 爆速伝票入力UIとリアルタイム自動仕訳連動機能を実装する
• Phase 3: インボイル制度・電帳法（改ざん防止ハッシュチェーン）への完全対応を実現する
• Phase 4: 在庫管理・顧客管理モジュールを統合し、全体的なシステムとして完成させる

🎯 ターゲットユーザー

• 個人事業主
• 小規模店舗（飲食店、小売店など）

ユーザー属性

• 少人数のスタッフで運営される店舗
• 操作はシンプルかつ直感的であることが重要
• 時間効率を重視する
• 既存の弥生システムから移行することを想定している

🛠️ 技術スタック

バックエンド

• 言語: TypeScript (Node.js)
• フレームワーク: Hono または Express
• ORM: Drizzle ORM
• データベース: SQLite (STRICT mode) → 将来的に PostgreSQL への切り替え対応

フロントエンド

• React / Next.js
• 型定義の完全共有（TypeScript）

📁 ドキュメント構造

docs/
├── README.md              # このファイル
├── 01-概要/               # プロジェクト概要
│   ├── PROJECT.md         # プロジェクトコンテキスト定義
│   └── ROADMAP.md         # フェーズ構造とスケジュール
├── 02-要件定義/           # 詳細要件
│   └── REQUIREMENTS.md    # 要件定義書
├── 03-フェーズ1/          # Phase 1: 弥生互換コア
│   ├── PLAN.md            # 実装計画
│   └── IMPLEMENTATION.md  # 実装ログ（将来）
├── 04-フェーズ2/          # Phase 2: 爆速伝票入力UI
├── 05-フェーズ3/          # Phase 3: インボイル・電帳法対応
└── 06-フェーズ4/          # Phase 4: 在庫・顧客管理

🚀 フェーズ構造

Phase 1: 弥生互換コア ＆ 相互データ変換（最優先MVP）

期間: 2〜3週間 | 優先度: 最高

弥生販売・会計の完全上位互換を確立するための基盤となる共通データモデルとCSV相互運用エンジンを実装します。

Phase 2: 爆速伝票入力UI ＆ リアルタイム自動仕訳

期間: 3〜4週間 | 優先度: 高

テンキー/ファンクションキー主体の爆速伝票入力UIを実装し、販売伝票確定時に自動的に会計仕訳データを生成するリアルタイム自動仕訳連動機能を実現します。

Phase 3: インボイル・電帳法・法制度対応

期間: 2〜3週間 | 優先度: 高

インボイル制度・電帳法（改ざん防止ハッシュチェーン）への完全対応を実現します。

Phase 4: 在庫・顧客管理モジュールの結合と全体統合

期間: 3〜4週間 | 優先度: 中

在庫管理機能と顧客管理（CRM）機能を実装し、全体システムとしての統合テストと最適化を行います。

📊 プロジェクトスケジュール

フェーズ	期間	開始日	完了日
Phase 1	2〜3週間	T+0	T+14〜21
Phase 2	3〜4週間	T+15	T+35
Phase 3	2〜3週間	T+36	T+49
Phase 4	3〜4週間	T+50	T+70

合計期間: 約10週間（2.5ヶ月）

✅ 成功基準

Phase 1 の成功基準

• 弥生形式CSVファイルのインポートが正常に動作する
• インポートされたデータが正確にデータベースに格納される
• データベースから弥生形式CSVとしてエクスポートできる
• Drizzle ORM + SQLite (STRICT/WAL) による共通データモデルが実装されている

Phase 2 の成功基準

• テンキー/ファンクションキー主体の伝票入力UIが実装される
• 販売伝票確定時に自動的に仕訳データが生成される
• イベント駆動型のリアルタイム自動仕訳連動が実装される

Phase 3 の成功基準

• 電帳法対応のPDF帳票が生成できる（改ざん防止ハッシュチェーン付き）
• インボイル制度に準拠した請求書が作成できる
• 全銀協（FBデータ）フォーマットで振込・代金回収が可能

Phase 4 の成功基準

• 在庫管理機能が正常に動作する
• 顧客管理機能が正常に動作する
• 全体システムとしての統合テストがパスする

📝 リリース計画

Alpha Release (Phase 1)

日付: フェーズ1完了後 内容: 弥生形式CSVの相互インポート/エクスポート機能のみ 対象: 内部テスト用

Beta Release (Phase 2)

日付: フェーズ2完了後 内容: 伝票入力UIと自動仕訳連動機能 対象: テストユーザー向け

Release Candidate (Phase 3)

日付: フェーズ3完了後 内容: インボイル制度・電帳法対応機能 対象: 検証用

Production Release (Phase 4)

日付: フェーズ4完了後 内容: 全体システムとしての完全版 対象: 一般ユーザー向け

🔗 リンク

• Forgejoリポジトリ: https://git.cyberius.biz/joe/hanbai
• Issues: GitHub Issues / Forgejo Issues

📄 ライセンス

MIT License

---

最終更新日: 2026年8月13日