Skip to content

CodeByStella/Buz-system-jp

BranchesTags

Repository files navigation

ビジネスシステム

業務効率化のためのビジネス管理システムです。Excelベースのデータ入力と自動計算機能を提供します。 image image

機能

認証システム

  • メール/パスワードログイン
  • ロールベース権限管理（管理者、一般ユーザー）

管理者機能

  • グローバルパラメータの管理
  • システム全体の設定変更

ユーザー機能

  • Excelライクなデータ入力フォーム
  • リアルタイム自動計算
  • データの自動保存
  • PDF出力機能

シート一覧

  • スタート
  • MQ(現状)
  • ①利益
  • ②⑧MQ(未来)
  • ③給料
  • ④経費
  • ⑤製造原価(人)
  • ⑥製造(経費)
  • ⑦原価詳細
  • 損益分岐点
  • 進捗実績値入力シート
  • 部門別販売計画
  • 利益計画表

技術スタック

  • フロントエンド: Next.js 14 (App Router), TypeScript, Tailwind CSS
  • バックエンド: Node.js + Express (独立サーバー)
  • データベース: MongoDB
  • ODM: Mongoose
  • 認証: JWT
  • PDF生成: jsPDF
  • Excel処理: ExcelJS
  • UIコンポーネント: shadcn/ui
  • 開発: フロントエンドとバックエンドの分離アーキテクチャ

セットアップ

前提条件

  • Node.js 18以上
  • MongoDB 4.4以上
  • npm または yarn
  • LibreOffice (PDF出力機能に必要)
  • 日本語フォント (Ubuntu/Linux環境で日本語表示に必要)

インストール

  1. リポジトリをクローン
git clone <repository-url>
cd business-system
  1. LibreOfficeのインストール

Windows:

  • LibreOffice公式サイトからダウンロードしてインストール
  • または Chocolatey を使用: choco install libreoffice

macOS:

  • LibreOffice公式サイトからダウンロードしてインストール
  • または Homebrew を使用: brew install --cask libreoffice

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install libreoffice
  1. 日本語フォントのインストール（Ubuntu/Linux環境のみ）
# 日本語フォントをインストール
sudo apt-get install fonts-noto-cjk fonts-noto-cjk-extra

# フォントキャッシュを更新
sudo fc-cache -fv

注意: Ubuntu/Linux環境では、PDF出力時に日本語文字が正しく表示されるよう、上記のフォントインストールが必要です。

  1. 依存関係をインストール

自動セットアップ（推奨）

# Windows
setup.bat

# Linux/Mac
chmod +x setup.sh
./setup.sh

手動セットアップ

# すべての依存関係をインストール
npm run install:all

# または個別にインストール
npm install
cd server && npm install
cd ../client && npm install
  1. 環境変数を設定

サーバー側

cp server/env.example server/.env

クライアント側

cp client/env.example client/.env.local

各.envファイルを編集して、適切な設定を行ってください。

  1. データベースをセットアップ
# MongoDBを起動（ローカル環境の場合）
mongod

# サンプルデータを作成
npm run db:seed
  1. 開発サーバーを起動

オプション1: フロントエンドとバックエンドを同時に起動

npm run dev

オプション2: 個別に起動

# バックエンドサーバー (ポート3001)
npm run dev:server

# フロントエンド (ポート3000) - 別のターミナルで
npm run dev:client

アプリケーションは以下でアクセスできます：

  • フロントエンド: http://localhost:3000
  • バックエンドAPI: http://localhost:3001

プロジェクト構造

├── server/               # Express バックエンド
│   ├── index.ts          # メインサーバー
│   ├── routes/           # API ルート
│   │   ├── auth.ts       # 認証
│   │   ├── admin.ts      # 管理者機能
│   │   ├── user.ts       # ユーザー機能
│   │   ├── exportExcel.ts # Excel出力
│   │   └── exportPDF.ts  # PDF生成
│   ├── middleware/       # ミドルウェア
│   ├── models/          # MongoDBモデル
│   ├── services/        # ビジネスロジック
│   ├── repositories/    # データアクセス層
│   ├── lib/             # ユーティリティ
│   └── package.json     # サーバー依存関係
├── client/              # Next.js フロントエンド
│   ├── app/             # Next.js App Router
│   ├── components/      # React コンポーネント
│   │   ├── ui/          # shadcn/ui コンポーネント
│   │   ├── auth/        # 認証コンポーネント
│   │   ├── layout/      # レイアウトコンポーネント
│   │   └── sheets/      # シートコンポーネント
│   ├── lib/             # フロントエンドユーティリティ
│   └── package.json     # クライアント依存関係
├── package.json         # ルート依存関係
└── README.md           # ドキュメント

データベーススキーマ

Users

  • _id: ユーザーID (ObjectId)
  • email: メールアドレス
  • name: 名前
  • password: ハッシュ化されたパスワード
  • role: ロール（ADMIN/USER）
  • createdAt: 作成日時
  • updatedAt: 更新日時

GlobalParameters

  • _id: パラメータID (ObjectId)
  • key: パラメータキー
  • value: パラメータ値
  • description: 説明
  • createdAt: 作成日時
  • updatedAt: 更新日時

Data (UserInputs)

  • _id: 入力ID (ObjectId)
  • user: ユーザーID
  • sheet: シート名
  • cellKey: セルキー
  • value: 入力値
  • createdAt: 作成日時
  • updatedAt: 更新日時

API エンドポイント

すべてのAPIエンドポイントは http://localhost:3001 で提供されます。

認証

  • POST /api/auth/login - ログイン
  • POST /api/auth/logout - ログアウト
  • GET /api/auth/me - 現在のユーザー情報

管理者

  • GET /api/admin/parameters - グローバルパラメータ取得
  • POST /api/admin/parameters - グローバルパラメータ更新

ユーザー

  • GET /api/user/inputs - ユーザー入力データ取得
  • POST /api/user/inputs - ユーザー入力データ保存
  • POST /api/calculate - 計算実行
  • POST /api/export/pdf - PDF生成
  • POST /api/export/excel - Excel生成

ヘルスチェック

  • GET /api/health - サーバー状態確認

計算エンジン

TypeScriptで実装された純粋関数ベースの計算エンジンです。

主要機能

  • 基本的な四則演算
  • ビジネス固有の計算（利益率、損益分岐点など）
  • リアルタイム計算
  • 依存関係の自動解決

計算式例

  • 利益計算: 売上 - コスト
  • 利益率: (利益 / 売上) × 100
  • 損益分岐点: 固定費 / 貢献利益

トラブルシューティング

PDF出力に関する問題

問題: PDF出力時に日本語文字が四角形（□）で表示される

  • 原因: Ubuntu/Linux環境で日本語フォントが不足
  • 解決方法: 
    sudo apt-get install fonts-noto-cjk fonts-noto-cjk-extra
sudo fc-cache -fv

問題: LibreOfficeのGUIウィンドウが表示される

  • 原因: Windows環境でLibreOfficeがヘッドレスモードで実行されていない
  • 解決方法: 最新のコードでは自動的にヘッドレスモードで実行されます

問題: PDF出力が失敗する

  • 原因: LibreOfficeがインストールされていない、またはパスが通っていない
  • 解決方法:
    • LibreOfficeが正しくインストールされているか確認
    • 環境変数でLibreOfficeのパスを指定（必要に応じて）

環境別の注意点

Windows:

  • LibreOfficeは自動的に検出されます
  • GUIウィンドウは表示されません（ヘッドレスモード）

macOS:

  • LibreOfficeは自動的に検出されます
  • 日本語フォントは標準で利用可能

Ubuntu/Linux:

  • 日本語フォントのインストールが必要
  • LibreOfficeのインストールが必要
  • フォントキャッシュの更新が必要

デプロイ

本番環境でのセットアップ

  1. 環境変数の設定
MONGODB_URI="mongodb+srv://username:password@cluster.mongodb.net/business_system"
JWT_SECRET="your-production-jwt-secret"
FRONTEND_URL="https://your-domain.com"
CONVERTAPI_SECRET="your-convertapi-secret"
  1. データベースセットアップ
# MongoDBクラスターに接続してデータベースを作成
# サンプルデータを投入
npm run db:seed
  1. アプリケーションのビルド
npm run build
npm start

ライセンス

このプロジェクトはMITライセンスの下で公開されています。

サポート

問題や質問がある場合は、GitHubのIssuesページで報告してください。

About

tanoukou-skill.cloud/

Resources

Readme
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages