# lcydt

**Repository Path**: iotplc/lcydt

## Basic Information

- **Project Name**: lcydt
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-25
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OA 智能办公平台 (LCYDT)

一个企业级智能化办公管理系统，集成流程审批、表单设计、文档管理、数据权限等功能，支持多租户架构与跨端部署。

[![Go Version](https://img.shields.io/badge/Go-1.21+-green.svg)](https://golang.org)
[![Vue Version](https://img.shields.io/badge/Vue-3.4+-blue.svg)](https://vuejs.org)
[![uni-app Version](https://img.shields.io/badge/uni--app-3.0+-orange.svg)](https://uniapp.dcloud.net.cn)

---

## 📖 项目简介

本项目是一套完整的企业级 OA 办公系统解决方案，采用 **前后端分离** 架构设计：

- **后端服务**：基于 Go + GORM 的高性能 RESTful API 服务
- **Web 管理端**：Vue 3 + Element Plus 的响应式管理后台
- **移动端 App**：uni-app + wot-ui 的跨平台移动应用（支持小程序/H5/App）

### 核心功能模块

| 模块 | 描述 |
|------|------|
| 🔐 **流程引擎** | 可视化流程设计器，支持条件分支、会签、抄送等复杂审批逻辑 |
| 📋 **表单设计器** | 拖拽式表单构建，支持子表、数据源联动、动态校验 |
| 🏢 **多租户** | 租户隔离、数据权限控制、自定义组织架构与部门预算 |
| 📄 **电子文档** | 在线预览、编辑、水印保护、共享协作、访问审计 |
| 📊 **数据分析** | 报表管理、流程数据统计、自定义仪表盘 |
| 🚗 **车辆管理** | 用车申请、保险到期提醒、加油记录、费用统计 |
| 👥 **考勤管理** | 排班设置、打卡记录、异常处理、假期管理 |
| 💼 **人事管理** | 入职转正离职、调岗调动、薪资档案 |

---

## 🏁 快速开始

### 环境要求

- **后端**：
  - Go 1.21+
  - MySQL 8.0+
  
- **前端（Web）**：
  - Node.js 18+
  - pnpm 8+
  
- **移动端**：
  - HBuilderX 3+（推荐）或 uni-app CLI
  - Node.js 16+

### 安装步骤

#### 1️⃣ 数据库初始化

```bash
# 导入初始化脚本（位于 oa_serve/server/scripts/）
mysql -u root -p <数据库名> < oa_serve/server/scripts/release_init.sql
```

#### 2️⃣ 后端部署 (`oa_serve`)

```bash
cd oa_serve
go mod download
go run main.go
```

默认端口：`http://localhost:8080`

#### 3️⃣ Web 管理端部署 (`oa_admin`)

```bash
cd oa_admin
pnpm install
pnpm dev
```

默认端口：`http://localhost:3000`

#### 4️⃣ 移动端 App 部署 (`oa_ts_app`)

```bash
cd oa_ts_app
pnpm install
pnpm dev:mp-weixin  # 编译为微信小程序
# 或使用 HBuilderX 运行到手机模拟器
```

---

## 🛠️ 技术栈

### 后端

- **语言**: [Go](https://golang.org/) 1.21+
- **ORM**: [GORM](https://gorm.io/) 
- **路由**: Gin / Echo
- **配置**: Viper

### 前端

- **框架**: [Vue 3](https://v3.vuejs.org/) (Composition API)
- **UI 库**: [Element Plus](https://element-plus.org/)
- **状态管理**: Pinia
- **HTTP**: Axios
- **构建工具**: Vite 5.x

### 移动端

- **框架**: [uni-app](https://uniapp.dcloud.net.cn/)
- **UI 组件**: [wot-ui](https://github.com/wot-design/wot-ui)
- **下拉刷新**: [z-paging](https://zfkai.github.io/z-paging/)

---

## 📦 项目结构

```
lcydt/
├── oa_serve/          # Go 后端服务
│   ├── server/
│   │   ├── wb/        # Workbench 工作区业务模块
│   │   │   ├── wb_controller/    # 控制器层
│   │   │   ├── wb_mapper/        # 数据访问层
│   │   │   ├── wb_model/         # 模型定义
│   │   │   ├── wb_engine/        # 流程引擎执行器
│   │   │   └── wb_vo/            # 视图对象
│   │   └── ...       # 其他业务模块
│   └── scripts/      # SQL 脚本与迁移
│
├── oa_admin/          # Web 管理后台
│   ├── src/
│   │   ├── views/    # 页面视图
│   │   ├── components/ # 公共组件
│   │   ├── utils/    # 工具函数
│   │   └── api/      # 接口封装
│   └── vite.config.ts
│
├── oa_ts_app/         # 移动端 App (uni-app)
│   ├── src/
│   │   ├── pages/    # 页面目录
│   │   ├── uni_modules/ # uni-app 插件
│   │   │   ├── z-paging/     # 下拉刷新分页组件
│   │   │   └── wot-ui/       # UI 组件库
│   │   └── utils/    # 工具函数
│   └── manifest.json   # 应用配置
│
├── oa_dt/             # DataTables 数据表格模块
│   └── ...
│
└── docs/              # 文档中心
    ├── 钉钉流程/       # 钉钉集成文档
    └── 使用说明.md     # 用户手册
```

---

## 🚀 特色功能

### 1. 可视化流程设计器

- 🎨 **拖拽式设计**：直观的操作界面，降低学习成本
- 🔄 **丰富的节点类型**：开始、结束、审批、抄送、条件分支、网关、并行任务等
- ⚙️ **灵活的分支规则**：按角色、部门、职级、表单字段值自动判断路径
- 📱 **移动端适配**：移动端实时预览流程效果

### 2. 多租户架构

- 🔒 **数据隔离**：租户间完全隔离，保障数据安全
-  **细粒度权限**：基于 RBAC 的数据权限模型，精确到行级别
- 📦 **套餐计划**：不同租户可绑定不同功能套餐限制资源用量

### 3. 电子文档管理

- 📄 **格式支持**：Word、Excel、PDF、PPT、图片、CAD 等
- 🔐 **安全控制**：在线预览、下载限制、防篡改水印
- 🔗 **协作共享**：生成分享链接，设置访问权限与有效期
- 📝 **审计日志**：记录所有操作行为，支持追溯分析

---

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

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

---

## 📄 License

本项目采用 MIT 许可证开源。

---

## 🆘 问题反馈

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

- [提交 Issue](https://gitee.com/iotplc/lcydt/issues)

---

<p align="center">
  Made with ❤️ by LCYDT Team
</p>