# SmartArchive

**Repository Path**: m40/smartArchive

## Basic Information

- **Project Name**: SmartArchive
- **Description**: 智能档案管理系统 - AI 驱动的档案搜索与管理平台
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-21
- **Last Updated**: 2026-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SmartArchive 智能档案管理系统

## 项目简介
SmartArchive 是一个基于 Spring Boot + Vue 的智能档案管理系统，支持动态建表和自定义页面展示。

## 核心功能
- 动态档案类型管理
- 运行时动态建表
- 自定义列表和编辑页面
- 基本的增删查改功能
- 元数据驱动架构
- AI 智能搜索
- 权限管理（RBAC）

## 技术栈

### 后端
- Spring Boot 3.5.x
- MyBatis-Plus 3.5.7
- Sa-Token 1.38.0（认证框架）
- Dynamic DataSource 4.3.1
- MySQL 8.0+ / H2（测试）

### 前端
- Vue 3.5.x + TypeScript
- Vite 6.0.x
- Element Plus 2.9.x
- Vue Router 4.5.x
- Axios 1.7.x

## 项目结构
```
SmartArchive/
├── .trae/rules/project_rules.md   # 项目开发规范
├── backend/                       # 后端服务 (Spring Boot)
│   ├── smartarchive-backend/      # 根聚合模块
│   ├── smartarchive-system/       # 系统管理模块
│   ├── smartarchive-archive/      # 档案管理模块
│   ├── smartarchive-ai/           # AI搜索模块
│   └── smartarchive-web/          # 启动入口模块
├── frontend/                      # 前端界面 (Vue 3 + TypeScript + Vite)
│   ├── src/
│   │   ├── views/                 # 页面组件
│   │   ├── router/                # 路由配置
│   │   ├── types/                 # TypeScript 类型定义
│   │   ├── utils/                 # 工具函数
│   │   ├── components/            # 通用组件
│   │   ├── App.vue                # 根组件
│   │   └── main.ts                # 入口文件
│   ├── index.html                 # HTML 模板
│   ├── vite.config.ts             # Vite 配置
│   ├── tsconfig.json              # TypeScript 配置
│   └── package.json               # 前端依赖
└── README.md
```

## 快速开始

### 环境要求
- JDK 17+
- Node.js 20+
- MySQL 8.0+

### 1. 克隆项目
```bash
git clone <repository-url>
cd SmartArchive
```

### 2. 初始化数据库
1. 创建数据库 `smartarchive`
2. 执行 `backend/smartarchive-web/src/main/resources/db/permission_schema.sql`

### 3. 配置环境变量

**后端配置** (`backend/smartarchive-web/src/main/resources/application-dev.yml`)：
```yaml
spring:
  datasource:
    dynamic:
      primary: master
      datasource:
        master:
          url: jdbc:mysql://localhost:3306/smartarchive?useSSL=false&serverTimezone=Asia/Shanghai
          username: root
          password: your_password
```

### 4. 启动后端服务
```bash
cd backend/smartarchive-web
mvn spring-boot:run
```

### 5. 启动前端服务
```bash
cd frontend
npm install
npm run dev
```

### 访问地址
- 前端页面: http://localhost:8081
- 后端API: http://localhost:8080/api
- 默认账号: admin / 123456

## 开发规范
请参考 `.trae/rules/project_rules.md` 文件了解项目开发规范。

## 项目特性

### 安全特性
- Sa-Token 认证框架
- BCrypt 密码加密
- 基于角色的访问控制（RBAC）
- 数据权限隔离

### 架构特点
- 前后端分离
- 微服务模块化设计
- RESTful API 设计
- 元数据驱动的动态表单

### 功能模块
1. **系统管理** - 用户、角色、机构、权限管理
2. **档案管理** - 档案类型定义、字段配置
3. **档案数据** - 数据录入、查询、报表
4. **档案检索** - 全文检索、AI智能搜索
5. **系统设置** - 数据字典、检索库管理

## 许可证
MIT License