# Goods **Repository Path**: duckwolf/Goods ## Basic Information - **Project Name**: Goods - **Description**: 同步前端系统 - **Primary Language**: Unknown - **License**: MulanPSL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2025-11-22 - **Last Updated**: 2025-11-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 广告置换库存管理系统 ## 项目简介 广告置换库存管理系统是一个多服务架构的企业级应用，用于管理广告置换业务中的库存、定价、渠道和财务结算。 ## 技术架构 ### 后端服务 - **主服务**: Spring Boot 3.x + MyBatis Plus + MySQL 8.0 - **定价服务**: Python FastAPI + Playwright + Redis - **消息队列**: RocketMQ - **缓存**: Redis ### 前端 - **框架**: React 18 + Ant Design 5 - **图表**: ECharts - **状态管理**: Redux Toolkit ### 基础设施 - **容器化**: Docker + Kubernetes - **CI/CD**: GitLab CI + Helm - **监控**: Prometheus + Grafana ## 快速开始 ### 环境要求 - Java 17+ - Python 3.11+ - Node.js 18+ - Docker & Docker Compose - MySQL 8.0 - Redis 7.0 ### 🔧 环境安装（通过代理服务器） #### Java 17+ 安装 请参考详细指南：[Java安装指南](JAVA_INSTALLATION_GUIDE.md) **快速命令（Windows + Chocolatey + 代理）:** ```powershell # 配置Chocolatey代理 choco config set proxy http://your-proxy:port # 安装OpenJDK 17 choco install openjdk17 -y ``` #### Python 3.11+ 安装 请参考详细指南：[Python安装指南](PYTHON_INSTALLATION_GUIDE.md) **快速命令（Windows + Chocolatey + 代理）:** ```powershell # 安装Python 3.11 choco install python311 -y # 配置pip代理 pip config set global.proxy http://your-proxy:port ``` ### 本地开发 #### 1. 启动基础设施服务 ```bash cd devops docker-compose up -d mysql redis rocketmq ``` #### 2. 启动后端服务 ```bash cd backend # 安装依赖（通过代理） mvn clean install -DproxyHost=your-proxy -DproxyPort=port # 启动应用 mvn spring-boot:run ``` #### 3. 启动定价服务 ```bash cd pricing-service # 安装依赖（通过代理） pip install --proxy=http://your-proxy:port -r requirements.txt # 启动服务 python main.py ``` #### 4. 启动前端 ```bash cd frontend # 安装依赖 npm config set proxy http://your-proxy:port npm install npm start ``` ## 项目结构 ``` ad-stock-swap-system/ ├── backend/ # Spring Boot主服务 ├── pricing-service/ # Python定价服务 ├── frontend/ # React前端 ├── database/ # 数据库脚本 ├── devops/ # DevOps配置 ├── docs/ # 项目文档 └── tests/ # 测试脚本 ``` ## 核心功能 ### 1. 库存管理 - SKU信息维护 - Excel批量导入 - 库存状态管理 - 风控规则检查 ### 2. 智能定价 - 实时价格抓取（拼多多、闲鱼） - 变现率计算 - 风险评估 - 缓存优化 ### 3. 渠道管理 - 渠道信息维护 - 佣金率配置 - 结算方式管理 ### 4. 财务结算 - 利润预测 - 渠道现结 - 财务报表 ### 5. 媒体排期 - 广告位管理 - 排期冲突检测 - 自动下线机制 ## API文档 详细的API文档请参考 [api-specification.md](docs/api-specification.md) ## 部署指南 生产环境部署请参考 [deployment-guide.md](docs/deployment-guide.md) ## 开发规范 ### 代码规范 - Java: Google Java Style Guide - Python: PEP 8 - JavaScript: Airbnb Style Guide ### Git提交规范 ``` ():