lkdenchin/etu-smart-cabinet

This project, whose Chinese name translates roughly to Easy Pickup Treasure, is a student-style smart locker system that combines real hardware with a mobile app and a web admin panel. The idea is the kind of pickup locker bank you see in apartment lobbies or campus mail rooms: someone leaves an item inside one of several small compartments, the recipient gets a pickup code, and the compartment opens for them. The README is in Chinese, with an English version linked from the top. There are four pieces. A Node.js backend built with Express runs on port 1145 and stores everything in a MySQL or MariaDB database; user logins are handled with JWT tokens. A mobile app built with UniApp (a cross-platform framework based on Vue) is the user-facing surface, with 24 pages covering deposit, pickup, history, themes, customization, and a small community section. A separate web admin panel uses Vue 3, Vite, Element Plus, and ECharts for charts. The cabinet itself runs on an ESP32-C3 microcontroller with two attached components: a photoelectric (light-beam) sensor to tell whether a slot has something in it, and a PN532 NFC module that can write tags. The deposit workflow goes like this. The user picks a cabinet and a slot in the app. The backend generates a pickup code and an NFC ID. The ESP32 writes the recipient's phone number to a physical NFC tag. The depositor places the item in the slot, the light sensor sees that the slot is now occupied, and the database flips the slot to occupied. To collect, the recipient either taps the NFC tag on the cabinet or types the pickup code; the server confirms it; the sensor sees the slot become empty and marks it available. The anti-theft feature uses the same sensor. If a slot goes from occupied to empty without a matching pickup request on file, the system automatically files a theft warning that the admin panel can review and resolve. The community area has discussion, feedback, activity, and customization tabs where users can submit orders for custom cabinet designs. The project is released under the MIT license.