# 办公用品管理系统

**Repository Path**: lktx/stock-system

## Basic Information

- **Project Name**: 办公用品管理系统
- **Description**: 办公用品管理系统办公用品管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-25
- **Last Updated**: 2026-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 办公用品出入库管理系统 V1.0

轻量级的 B/S 架构办公用品出入库管理工具，使用 Go + SQLite 后端，Vite + Vue 3 + Element Plus 前端。

## 技术栈

- **前端**: Vite 8 + Vue 3 + Element Plus + Pinia + Vue Router + Axios
- **后端**: Go + Gin + SQLite (WAL模式)
- **认证**: JWT Token

## 快速启动

### 方式一：双击运行

```
双击 start.bat
```

### 方式二：分别启动

**启动后端**：
```bash
cd backend
go run main.go
```
后端运行在 `http://localhost:27175`

**启动前端**：
```bash
cd frontend
npm run dev
```
前端运行在 `http://localhost:3000`

## 部署说明

- 前端通过 Vite 代理 `/api` 到后端，开发时前端直接请求 `/api/xxx`
- 生产环境前端构建后部署到 `https://stock.sclktx.com`，后端运行在 `https://stock.sclktx.com/api`
- 前端 `baseURL` 统一使用 `/api`，无需根据环境切换

## 访问地址

| 页面 | 地址 | 说明 |
|:---|:---|:---|
| 管理员登录 | http://localhost:3000/#/login | admin / admin123 |
| 统计看板 | 登录后首页 | 日/周/月统计 |
| 物品管理 | 登录后菜单 | 增删改物品 |
| 入库记录 | 登录后菜单 | 查看入库流水 |
| 出库记录 | 登录后菜单 | 查看出库流水 |
| 部门管理 | 登录后菜单 | 树形管理 |
| 领用申请 | http://localhost:3000/#/stock-out | **无需登录** |

## 功能列表

1. **物品管理** — 搜索、CRUD、行内入库弹窗、库存预警、详情弹窗(入库/出库记录分页)
2. **入库管理** — 事务性更新库存，支持单价/供应商信息
3. **出库管理** — 自动校验库存是否充足，事务性扣减库存，记录所属部门/领用人/用途
4. **公开领用** — 无需登录即可提交领用申请
5. **统计看板** — 今日/本周/本月/上月快捷筛选，自定义日期区间，出入库趋势图，汇总卡片
6. **部门管理** — 树形结构展示，新增/编辑/删除子部门
7. **JWT认证** — 管理员登录保护，Token过期自动跳转登录页
8. **移动端适配** — 响应式布局，侧边栏折叠，表格横向滚动

## 默认账号

- 管理员: **admin** / **admin123**

## 环境变量

| 变量 | 说明 | 默认值 |
|:---|:---|:---|
| `BASE_URL` | 后端 API 基础路径 | `/api` |
| `SERVER_PORT` | 后端监听端口 | `:27175` |