品牌资产管理

一个集成的多界面品牌资产管理系统,提供增强的搜索、元数据和部署功能,适用于企业品牌资产管理工作流程。

  • by b-ciq
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 b-ciq/brand-assets-ecosystem

使用说明

🎨 品牌资产生态系统

集成的多界面品牌资产管理系统,具有增强的搜索、元数据和部署功能。

🏗️ 架构概述

📁 brand-assets-ecosystem/
├── 📁 core-mcp-dev/           # Enhanced MCP server (development)
├── 📁 interfaces/
│   ├── 📁 web-gui/           # Next.js web browser interface
│   └── 📁 slack-app/         # Future Slack integration
├── 📁 shared/                # Common types and SDKs
└── 📁 docs/                  # Documentation

🚀 快速开始

Web GUI开发

cd interfaces/web-gui
npm install
npm run dev
# → http://localhost:3002

MCP开发服务器

cd core-mcp-dev  
python3 server.py
# → Local MCP server for development

🎯 当前状态

✅ 工作特点

  • Web图形用户界面:资产浏览、搜索、下载
  • 资产规模:最大高度限制为100px
  • MCP集成:支持本地和云端点
  • 共享架构:支持多种接口

🚧 在开发中

  • 增强元数据:人类可读的名称,更好的标记
  • 改进的搜索:品牌/布局/背景过滤
  • PDF预览:可视化文档预览
  • Slack集成:团队聊天集成

🔄 开发工作流程

生产vs发展

  • 生产MCP: brand-assets repo → FastMCP云
  • 开发MCP: core-mcp-dev/ → 局部测试
  • Web图形用户界面:可以连接到任一端点

安全开发流程

  1. 修改 core-mcp-dev/ 改进
  2. 测试 在本地使用web GUI
  3. 部署 准备就绪后,进行FastMCP的暂存
  4. 迁移 经证明稳定的生产

📦 组件

核心MCP开发(core-mcp-dev/)

原始MCP的增强版本,具有:

  • 更好的元数据生成
  • 改进的搜索功能
  • 人类可读的资产名称
  • 增强的标签系统

Web图形用户界面(interfaces/web-gui/)

Next.js应用程序提供:

  • 可视化资产浏览
  • 高级搜索和过滤
  • 下载功能
  • 响应式设计

共享SDK(shared/)

常见实用程序:

  • TypeScript接口
  • API客户端库
  • 共享业务逻辑

🌐 部署

当前部署

  • 生产MCP: brand-asset-server.fastmcp.app
  • 克劳德桌面:使用生产MCP的团队✅
  • Web图形用户界面:仅限于当地发展

计划部署

  • 暂存MCP:用于测试的新FastMCP端点
  • 生产Web GUI:待定(Vercel/Netlify)
  • Slack应用程序:未来整合

🛠️ 开发命令

再进行

# Web GUI
cd interfaces/web-gui && npm install

# MCP (if needed)
cd core-mcp-dev && pip install -r requirements.txt

开发服务器

# Web GUI (port 3002)
npm run dev

# MCP Server (local testing) 
python3 core-mcp-dev/server.py

测试

# Test MCP directly
python3 core-mcp-dev/cli_wrapper.py "CIQ logo"

# Test web GUI
# → Open http://localhost:3002

📚 文档

🤝 贡献

Git工作流

# Create feature branch
git checkout -b feature/enhanced-metadata

# Make changes, test locally
npm run dev  # test web gui
python3 core-mcp-dev/cli_wrapper.py "test"  # test mcp

# Commit and push
git add .
git commit -m "Add enhanced metadata generation"
git push origin feature/enhanced-metadata

测试检查表

  • []Web GUI加载并显示资产
  • []搜索功能正常工作
  • []资产下载工作
  • []MCP服务器响应查询
  • []不对现有API进行突破性更改

🎯 路线图

第2阶段:增强元数据(下)

  • 人类可读的资产名称
  • 改进了标记和分类
  • 更好的搜索功能

第三阶段:视觉增强

  • PDF预览生成
  • 多格式支持
  • 增强的资产查看器

第四阶段:团队整合

  • Slack应用程序开发
  • 部署自动化
  • 团队协作功能

🚀 准备好使用企业级工具增强您的品牌资产工作流程!