# WIS

**Repository Path**: liao_java/wis

## Basic Information

- **Project Name**: WIS
- **Description**:  WIS（财智通 Wealth Intelligence System）个人财富管理系统
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-30
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WIS（财智通 Wealth Intelligence System）个人财富管理系统

<div align="center">

![Vue](https://img.shields.io/badge/Vue-3.3+-4FC08D?logo=vuedotjs&logoColor=white)
![SpringBoot](https://img.shields.io/badge/SpringBoot-3.1+-6DB33F?logo=springboot&logoColor=white)
![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?logo=typescript&logoColor=white)
![Java](https://img.shields.io/badge/Java-17+-ED8B00?logo=openjdk&logoColor=white)

**专业 · 安全 · 智能的个人财富管理平台**

[项目介绍](#项目介绍) • [功能特性](#功能特性) • [技术架构](#技术架构) • [快速开始](#快速开始) • [开发指南](#开发指南)

</div>

## 📋 项目介绍

WIS（Wealth Intelligence System）个人财富管理系统是一款专业的个人财务管理工具，旨在帮助用户全面掌握财务状况，实现智能化的财富管理和规划。

### 🎯 核心价值
- **全面资产管理**：统一管理银行账户、投资、信用卡等多类型资产
- **智能财务分析**：基于AI算法提供个性化的财务建议
- **安全可靠**：银行级安全防护，保障用户数据安全
- **多端适配**：支持Web端和移动端，随时随地管理财富

## ✨ 功能特性

### 🏠 仪表盘
- 财务概览与核心指标展示
- 资产分布可视化图表
- 收支趋势分析
- 实时财务健康度评估

### 💰 资产管理
- 多账户统一管理（银行、现金、投资、信用卡等）
- 资产分类与标签系统
- 余额自动同步与提醒
- 资产配置优化建议

### 💳 交易管理
- 智能交易记录与分类
- 支持批量导入与导出
- 定期交易自动执行
- 消费习惯分析报告

### 🎯 目标规划
- 财务目标设定与跟踪
- 储蓄计划可视化
- 目标进度实时监控
- 成就系统与激励反馈

### ⚠️ 风险管理
- 个人风险承受能力评估
- 投资组合风险分析
- 市场波动预警
- 个性化风险控制建议

### 📊 报表分析
- 多维度财务报表
- 收支对比分析
- 净资产趋势跟踪
- 可定制化报告生成

## 🏗️ 技术架构

### 前端技术栈
| 技术领域 | 技术选型 | 版本 |
|---------|----------|------|
| 前端框架 | Vue 3 | 3.3+ |
| 开发语言 | TypeScript | 5.0+ |
| UI组件库 | Element Plus | 2.3+ |
| 状态管理 | Pinia | 2.1+ |
| 路由管理 | Vue Router | 4.2+ |
| 构建工具 | Vite | 4.4+ |
| HTTP客户端 | Axios | 1.5+ |
| 图表库 | ECharts | 5.4+ |

### 后端技术栈
| 技术领域 | 技术选型 | 版本 |
|---------|----------|------|
| 后端框架 | Spring Boot | 3.1+ |
| 开发语言 | Java | 17+ |
| 安全框架 | Spring Security | 6.1+ |
| ORM框架 | MyBatis Plus | 3.5+ |
| 数据库 | MySQL | 8.0+ |
| 缓存 | Redis | 7.0+ |
| 任务调度 | XXL-Job | 2.4+ |
| API文档 | SpringDoc OpenAPI | 2.2+ |

### 系统架构图
```
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   前端应用        │    │    网关层         │    │    应用服务层     │
│   Vue 3 SPA     │◄──►│   Nginx         │◄──►│   Spring Boot   │
│   TypeScript    │    │   负载均衡        │    │   微服务集群      │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                                           │
                                                           ▼
                                                 ┌─────────────────┐
                                                 │    数据存储层     │
                                                 │   MySQL 8.0     │
                                                 │   Redis 7.0     │
                                                 └─────────────────┘
```

## 🚀 快速开始

### 环境要求
- Node.js 18.0+
- Java 17+
- MySQL 8.0+
- Redis 7.0+

### 前端部署

```bash
# 克隆项目
git clone https://github.com/your-org/wis-frontend.git
cd wis-frontend

# 安装依赖
npm install

# 开发环境运行
npm run dev

# 构建生产版本
npm run build

# 代码检查
npm run lint

# 单元测试
npm run test:unit
```

### 后端部署

```bash
# 克隆项目
git clone https://github.com/your-org/wis-backend.git
cd wis-backend

# 编译项目
mvn clean compile

# 运行测试
mvn test

# 打包应用
mvn package -DskipTests

# 运行应用
java -jar target/wis-backend-1.0.0.jar
```

### Docker 部署

```yaml
# docker-compose.yml
version: '3.8'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
      MYSQL_DATABASE: wis_data
    volumes:
      - mysql_data:/var/lib/mysql

  redis:
    image: redis:7.0-alpine
    volumes:
      - redis_data:/data

  backend:
    build: ./wis-backend
    environment:
      SPRING_PROFILES_ACTIVE: prod
    depends_on:
      - mysql
      - redis

  frontend:
    build: ./wis-frontend
    ports:
      - "80:80"
    depends_on:
      - backend

volumes:
  mysql_data:
  redis_data:
```

## 🛠️ 开发指南

### 项目结构

```
wis-frontend/                 wis-backend/
├── public/                   ├── src/main/java/com/wis/
├── src/                      │   ├── controller/
│   ├── api/                  │   ├── service/
│   ├── assets/               │   ├── mapper/
│   ├── components/           │   ├── entity/
│   ├── composables/          │   ├── dto/
│   ├── layouts/              │   ├── config/
│   ├── router/               │   └── exception/
│   ├── stores/               ├── src/main/resources/
│   ├── types/                └── pom.xml
│   ├── utils/
│   ├── views/
│   └── main.ts
├── package.json
└── vite.config.ts
```

### 代码规范

#### 前端规范
- 使用 TypeScript 严格模式
- 组件采用 Composition API
- 统一的代码风格和命名规范
- ESLint + Prettier 代码格式化

#### 后端规范
- 遵循阿里巴巴 Java 开发规范
- 统一的异常处理机制
- RESTful API 设计规范
- 完整的日志记录体系

### API 文档

启动后端服务后访问：
```
http://localhost:8080/swagger-ui.html
```

### 数据库初始化

```sql
-- 创建数据库
CREATE DATABASE wis_data CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 初始化表结构
-- 详见 docs/database/init.sql
```

## 📊 性能指标

| 指标项 | 目标值 | 当前状态 |
|--------|--------|----------|
| 页面加载时间 | ≤ 2秒 | ✅ 达标 |
| API响应时间 | ≤ 500ms | ✅ 达标 |
| 系统可用性 | ≥ 99.5% | 🟡 测试中 |
| 并发用户数 | 1000+ | 🟡 测试中 |

## 🤝 贡献指南

我们欢迎所有形式的贡献！请阅读我们的贡献指南：

1. **提交 Issue**：报告 bug 或提出新功能建议
2. **代码贡献**：遵循我们的代码规范提交 Pull Request
3. **文档改进**：帮助完善项目文档
4. **测试反馈**：参与测试并提供反馈意见

### 开发流程
```bash
# 1. Fork 项目
# 2. 创建功能分支
git checkout -b feature/amazing-feature

# 3. 提交更改
git commit -m 'Add some amazing feature'

# 4. 推送到分支
git push origin feature/amazing-feature

# 5. 创建 Pull Request
```

## 📝 更新日志

### v1.0.0 (2025-11-29)
- ✅ 基础架构搭建完成
- ✅ 用户认证系统
- ✅ 资产管理模块
- ✅ 交易记录功能
- ✅ 仪表盘数据可视化

## 🐛 问题反馈

如果您遇到任何问题，请通过以下方式反馈：

1. [提交 Issue](https://github.com/your-org/wis-system/issues)
2. 发送邮件至：support@wis-system.com
3. 加入技术交流群：扫描二维码

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🙏 致谢

感谢所有为这个项目做出贡献的开发者！

---

<div align="center">

**WIS个人财富管理系统** - 让财富管理更简单、更智能

[官网](https://wis-system.com) • [文档](https://docs.wis-system.com) • [演示](https://demo.wis-system.com)

</div>