Mercado Libre Monorepo

Mercado Libre Monorepo

このプロジェクトは、Mercado Libre 関連の複数のアプリケーションとパッケージを含むモノレポです。依存関係とビルドを効率的に管理するため、pnpm workspaces と Turborepo を使用して構築されています。

📚 追加ドキュメント

この技術テストの目的と、採用された技術的な判断について理解を深めるには、documents/ ディレクトリにある詳細なドキュメントを確認してください。以下の内容が記載されています。

• 解決する問題の説明
• 技術的な判断の根拠
• システムアーキテクチャ
• 設計上の考慮事項
• 実装ガイド

🏗️ プロジェクト構成

mercado-libre-monorepo/
├── apps/
│   ├── frontend/     # Aplicación frontend
│   ├── backend/      # Servidor backend
│   └── mcp-server/   # Servidor MCP
├── packages/         # Paquetes compartidos
└── package.json      # Configuración principal

🚀 主なテクノロジー

• pnpm：パッケージマネージャー（バージョン 10.11.0）
• Turborepo：モノレポ向けビルドツール
• TypeScript：プログラミング言語
• Prettier：コードフォーマッター

📋 前提条件

• Node.js（推奨バージョン：18.x 以降）
• pnpm（バージョン 10.11.0）

🛠️ インストール

1. リポジトリをクローンします。

git clone [URL_DEL_REPOSITORIO]
cd mercado-libre-monorepo

2. 依存関係をインストールします。

pnpm install

🏃‍♂️ 使用可能なスクリプト

• pnpm build：すべてのアプリケーションをビルドします
• pnpm dev：すべてのアプリケーションを開発モードで起動します
• pnpm dev:front：フロントエンドのみを起動します
• pnpm dev:back：バックエンドのみを起動します
• pnpm dev:mcp：MCP サーバーをビルドします
• pnpm lint：すべてのプロジェクトでリンターを実行します
• pnpm format：Prettier を使用してコードをフォーマットします
• pnpm clean：生成されたファイルと node_modules を削除します

🔧 環境設定

1. 各アプリケーションで必要な環境変数が設定されていることを確認してください。
2. 各アプリケーション固有の設定ファイルは、apps/ の各サブディレクトリにあります。

📦 依存関係の管理

• 共有依存関係は pnpm workspaces で管理します
• 各アプリケーションには、固有の依存関係を設定できます
• 開発依存関係はモノレポ全体で共有します

🤝 コントリビューション

1. 機能用のブランチを作成します（git checkout -b feature/AmazingFeature）
2. 変更をコミットします（git commit -m 'feat: add amazing feature'）
3. ブランチにプッシュします（git push origin feature/AmazingFeature）
4. Pull Request を作成します

📝 コミット規約

このプロジェクトでは Conventional Commits の規約に従っています。

• feat：新機能
• fix：バグ修正
• chore：保守作業
• refactor：コードのリファクタリング

🔍 モニタリングとログ

• 各アプリケーションのログは、それぞれのディレクトリにあります
• フロントエンドにはブラウザーの開発者ツールを使用することをおすすめします
• バックエンドのログはコンソールから監視できます

🚨 トラブルシューティング

問題が発生した場合は、次の点を確認してください。

1. すべての依存関係が正しくインストールされていることを確認します
2. 環境変数が設定されていることを確認します
3. 該当するアプリケーションのログを確認します
4. 各アプリケーションのディレクトリにあるドキュメントを参照します

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳しくは LICENSE.md をご覧ください。