Mercado Libre Monorepo

Mercado Libre Monorepo

这是一个包含多个与 Mercado Libre 相关的应用和软件包的 monorepo。项目使用 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：用于 monorepo 的构建工具
• 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 管理共享依赖项
• 每个应用都可以有自己的特定依赖项
• 开发依赖项在 monorepo 级别共享

🤝 贡献

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 文件。