个人练习项目-门店简易记账 v1.0 （5.03-6.08）

✨ 门店简易记账 v1.0 上线啦🐰

一人包揽产品、开发、测试、运维全流程，整整打磨一个月，终于把项目基座搭建完成！后续慢慢迭代升级，持续学习进阶💪

初衷很简单：帮家里门店告别手工记账。从门店开单、销售统计起步，一步步补齐商品、库存、订单、权限等模块，如今 v1.0 全流程顺利跑通，成就感满满🎉

这是一款门店自用的轻量进销存系统，代码已开源，欢迎大家点点 Star，有问题、想法都可以提 Issue 一起交流💬

🖥️ 前端技术栈

核心框架：React 18（函数组件 + Hooks）

构建工具：Vite 6

开发语言：TypeScript

UI 组件库：Ant Design 5

路由管理：React Router 6

状态管理：Zustand（搭配 persist 数据持久化）

HTTP 请求：Axios（JWT Bearer 认证，依据 1102 错误码实现双 Token 自动刷新）

数据图表：ECharts + echarts-for-react

交互动画：framer-motion

图片处理：antd-img-crop（头像等图片裁剪上传）

样式方案：CSS Modules + 全局 CSS

工程配置：路径别名 @/、开发环境代理 /api、/upload

开发辅助：本地 Mock 数据（VITE_USE_MOCK_DATA）

📦 前端功能概览

门店模块：售卖开单、配件维护、年度数据总览看板

工作台：首页数据指标卡片 + 可视化图表

商品管理：分类、品牌、商品列表，支持数据导入导出、商品上下架

库存管理：库存列表、入库、出库、库存预警、库存流水查询

订单管理：完整流程覆盖下单、支付、发货、退款

系统管理：用户 / 角色 / 权限 / 菜单、在线用户、登录日志、操作日志

系统监控：Redis、服务器、接口运行状态监控

个人中心：个人信息、个人操作日志

AI 实验区：SQL 助手、运维助手（部分功能为 Mock 数据，等待后端联调）

✨ 前端通用能力

支持登录注册、路由守卫、RBAC 动态菜单、按钮级权限控制、全局主题切换、统一接口封装。

⚙️ 后端技术 & 能力

后端基于 JDK 17 + Spring Boot 3.2.5 搭建单体架构，采用经典 Controller → Service → Mapper 三层架构，模块划分清晰，完整承接门店开单、商品库存、订单流转、系统权限、运维监控等全业务链路。

安全与数据存储

鉴权体系：Spring Security + JWT 双 Token + Redis，实现登录鉴权与会话缓存，Access/Refresh 令牌分工明确，前端通过 1102 错误码触发令牌无感刷新

数据存储：PostgreSQL + MyBatis-Plus，支持分页查询、逻辑删除

接口文档：集成 Knife4j，自动生成可视化在线接口文档

通用横切能力（AOP 实现）

基于 AOP 统一实现 RBAC 权限校验、操作日志记录、接口限流、API 运行监控；日志支持导出 Excel，监控维度包含 Redis 状态、服务器资源、接口耗时，项目具备完善的可观测性与可维护性。

🔮 未来规划

后续计划逐步完成：高并发改造、接入 AI 能力、向微服务 & 云原生方向演进，还会开发微信商城小程序～路还很长，稳步前行🛤️

暂时先关闭网站啦，目前开始技术迭代懒得去分环境了。就在这一个环境上搞了。

📌 开源仓库地址

前端：https://gitee.com/maria_love/store-inventory-front

后端：https://gitee.com/maria_love/store-inventory-backend

欢迎来玩，一起交流 🐰💕

登录页：

门店自用主页：

主页：

监控：

个人主页：