warehouse

This is a warehouse inventory management system built for small businesses, covering purchasing, sales, returns, and stock tracking. The README is written in Chinese. The system is split into a backend server and a browser-based frontend, which communicate over an API rather than being bundled together.

The backend is built with Spring Boot (Java 21) and stores data in a MySQL database. The frontend uses Vue 3 with TypeScript, and displays charts through ECharts. Together they provide a web application that warehouse staff open in a browser to manage day-to-day operations: recording goods coming in from suppliers, recording goods going out to customers, handling return transactions, and checking current stock levels.

A real-time dashboard on the home screen shows total product count, low-stock alerts, and today's purchasing and sales summary. There are three built-in report types: a purchase and sales amount trend chart, a product-level breakdown of what moved in and out, and a profit analysis that compares sales revenue against purchase cost to calculate gross margin. All reports can be filtered by today, this week, this month, this quarter, this year, or a custom date range.

The system also includes user and permission management, letting administrators define roles, departments, and menu access for different staff members. Customer records and supplier records are maintained separately. A recent addition (v1.2, May 2026) added support for walk-in retail sales, treating one-off customers without an account as a special case.

Setup requires Java 21, Maven, MySQL, and Node.js. The README provides commands to initialize the database, start the backend, and run the frontend dev server. A Docker configuration is also included, allowing the full stack (backend, frontend with Nginx, and MySQL) to be started together with a single compose command. The project is MIT licensed, with a note that free use, learning, and modification are permitted but direct resale of the software is not.