# 易标签web打印模板管理系统

**Repository Path**: elable/Label-Template-Management-System

## Basic Information

- **Project Name**: 易标签web打印模板管理系统
- **Description**: 一个专为标签打印模板管理系统的全栈服务，提供用户认证、文件上传下载、模板管理、访问记录追踪以及工作组和文件分享功能。

## 主要功能
- 用户认证与授权系统
- 文件模板的上传、下载和管理
- 访问记录追踪与统计
- 完整的前端界面实现
- 邮件通知系统
- 完善的日志记录

## 技术栈
- 后端：Node.js, Express.js, Sequelize ORM
- 数据库：MySQL
- **Primary Language**: JavaScript
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://www.yi-label.com/b-s-web-print
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-18
- **Last Updated**: 2025-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 易标签, 标签打印系统

## README

# 易标签web打印模板管理系统

#### 介绍
一个专为标签打印模板管理系统的全栈服务，提供用户认证、文件上传下载、模板管理、访问记录追踪以及工作组和文件分享功能。

官方服务网站：[api.yi-label.com](https://api.yi-label.com/frontend/login.html)

## 主要功能
### 核心功能
- 用户认证与授权系统，支持注册、登录、JWT验证
- 文件模板的上传、下载、预览和管理
- 访问记录追踪与统计分析
- 完整的前端界面实现，支持响应式设计
- 邮件通知系统，用于用户注册和重要操作提醒
- 完善的日志记录，包括API调用、错误和安全日志
### 高级功能 （未完成）
- 工作组管理：支持创建、管理工作组及成员邀请
- 模板分享机制：支持私有、指定用户、工作组和公开四种分享模式
- 权限控制系统：基于角色的细粒度权限管理
- 文件版本管理：追踪模板变更历史
- 多设备支持：适配桌面端和移动端访问

## 技术栈
- 后端：Node.js, Express.js, Sequelize ORM
- 数据库：MySQL
- 前端：HTML, CSS, JavaScript
- 认证：JWT (JSON Web Token)
- 工具库：Multer (文件上传), Winston (日志), Nodemailer (邮件)


#### 软件架构
系统采用经典的三层架构设计：

1. 表示层 ：HTML/CSS/JavaScript实现的前端界面，提供用户交互
2. 业务逻辑层 ：基于Express.js的API服务，处理核心业务逻辑
3. 数据访问层 ：使用Sequelize ORM与MySQL数据库交互

主要数据模型包括：

- User：用户信息管理
- File：文件模板存储与管理
- AccessRecord：访问记录追踪
- Group：工作组管理
- GroupUser：工作组与用户的关联
- TemplateShare：模板分享记录


#### 安装教程

详见 [部署指南](DEPLOYMENT_GUIDE.md) 进行环境搭建和配置。

#### 使用说明

### 快速开始
1. 安装依赖： npm install
2. 配置环境变量：根据 .env.example.txt 创建并配置 .env 文件
3. 初始化数据库： node init_db.js
4. 启动服务： node app.js

### 主要操作
- 用户管理 ：注册新用户、管理员登录、用户信息修改
- 模板管理 ：上传、预览、编辑、删除模板
- 分享设置 ：设置模板分享权限、管理分享记录 （开发中...）
- 工作组管理 ：创建工作组、邀请成员、管理权限（开发中...）

#### 参与贡献
欢迎社区成员参与项目贡献：

1. Fork 本仓库
2. 新建特性分支 ( git checkout -b feat/amazing-feature )
3. 提交更改 ( git commit -m 'Add some amazing feature' )
4. 推送到分支 ( git push origin feat/amazing-feature )
5. 开启 Pull Request


#### 特技

Web打印依赖易标签web打印客户端实现打印任务。

## 联系方式
如有问题或建议，请通过以下方式联系我们：

- 项目Issues：提交到项目仓库的Issue板块
- 技术支持：通过项目文档中提供的联系方式