# cosine

**Repository Path**: ycframe/cosine

## Basic Information

- **Project Name**: cosine
- **Description**: Cosine 是一个功能丰富的管理平台，包含用户管理、角色管理、权限控制、定时任务、工作流引擎等多个模块。该项目基于 Java 开发，使用了 Spring 框架，并结合了 Vue 等技术栈，提供了完整的前后端分离架构。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2023-05-15
- **Last Updated**: 2025-07-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cosine

## 项目概述

Cosine 是一个功能丰富的管理平台，包含用户管理、角色管理、权限控制、定时任务、工作流引擎等多个模块。该项目基于 Java 开发，使用了 Spring 框架，并结合了 Vue 等技术栈，提供了完整的前后端分离架构。

## 项目结构

- `cosine-admin`: 管理模块，包含系统管理、权限管理、日志管理等功能。
- `cosine-common`: 公共工具类和通用组件，如缓存、加密、数据验证等。
- `cosine-modules`: 模块化组件，提供基础服务和接口。

## 主要功能

- **用户管理**：支持用户注册、登录、权限分配、密码管理等。
- **角色管理**：定义不同角色及其权限，实现基于角色的访问控制（RBAC）。
- **权限管理**：细粒度的操作权限和数据权限控制。
- **日志管理**：记录用户操作日志，支持日志查询和清理。
- **定时任务**：支持定时任务的创建、编辑、删除和执行监控。
- **工作流引擎**：集成流程管理，支持流程部署、启动、审批等操作。
- **动态代码模块**：允许动态编写和执行代码，提升系统的灵活性。
- **文件管理**：支持文件上传、下载、删除等操作。

## 技术栈

- **后端**：Java、Spring Boot、MySQL、Redis
- **前端**：HTML、JavaScript、Vue.js
- **其他**：JWT、RSA 加密、Quartz 定时任务框架

## 安装与部署

### 环境要求

- JDK 1.8 或更高版本
- Maven 3.x
- MySQL 5.7 或更高版本
- Redis（可选）

### 构建步骤

1. **克隆项目**：
   ```bash
   git clone https://gitee.com/ycframe/cosine.git
   ```

2. **导入数据库**：
   - 创建数据库并导入 `cosine-admin` 模块中的 SQL 脚本。

3. **配置数据库连接**：
   - 修改 `cosine-admin/cosine-admin-system/cosine-admin-system-infrastructure/src/main/resources/application.yml` 文件中的数据库连接信息。

4. **构建项目**：
   ```bash
   cd cosine
   mvn clean install
   ```

5. **启动项目**：
   - 使用 IDE 运行 `cosine-admin` 模块的启动类 `AdminStartEvent`。
   - 或者使用命令行启动：
     ```bash
     java -jar cosine-admin/target/cosine-admin.jar
     ```

6. **访问系统**：
   - 打开浏览器，访问 `http://localhost:8080`，进入登录页面。

## 使用说明

### 登录系统

- 启动项目需要初始化管理员账号。
- 登录后可以进行用户管理、角色管理、权限分配等操作。

### 用户管理

- 系统管理员可以添加、删除、编辑用户信息。
- 支持用户角色分配和权限设置。

### 角色管理

- 创建角色并分配权限。
- 支持操作权限和数据权限的配置。

### 权限管理

- 细粒度的权限控制，支持按钮级别和数据级别的权限设置。

### 日志管理

- 查看用户操作日志，支持日志清理和导出。

### 定时任务

- 创建和管理定时任务，支持任务调度和执行日志查看。

### 工作流引擎

- 部署流程定义，启动流程实例，处理审批任务。

## 开发者指南

### 代码结构

- `cosine-admin`：管理后台的核心模块，包含控制器、服务层、DAO 层等。
- `cosine-common`：公共工具类和通用组件。
- `cosine-modules`：模块化组件，提供基础服务和接口。

### 代码贡献

- Fork 项目并创建新分支。
- 提交代码变更并发起 Pull Request。
- 参与讨论并完善文档。

## 许可证

该项目采用 Apache License 2.0 协议。详情请参阅 [LICENSE](LICENSE) 文件。

## 联系方式

如有任何问题或建议，请联系项目维护者或提交 Issue。

---

**注意**：本 README 为项目概述，具体功能和 API 使用请参考项目文档或源码注释。