# sonic-insight-studio

**Repository Path**: luli1314520/sonic-insight-studio

## Basic Information

- **Project Name**: sonic-insight-studio
- **Description**: 依照老师的一份项目计划书所写的一个项目，主要实现智能音源识别与定位的前端部分~
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://gitee.com/luli1314520/sonic-insight-studio
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-01
- **Last Updated**: 2025-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 音源跟踪系统（Sonic Insight Studio）

## 项目简介

本项目是一个基于 React + Vite + TypeScript + Tailwind CSS 的现代化音源跟踪与分析平台，集成了音频采集、信号处理、特征提取、音源定位、模型训练、性能分析、用户与权限管理、问题反馈、系统设置等多功能于一体，适用于声学实验、教学实训、科研分析等场景。

## 主要功能

- **音源采集**：支持实时音频信号采集与录制，麦克风类型与采样率可选，实时波形、电平监控、采集统计与历史记录。
- **信号处理**：内置多种滤波器（低通、高通、带通、带阻）、信号源生成、放大器设置，支持时域/频域分析与处理历史。
- **特征提取**：支持 MFCC、频谱图等特征提取，参数可调，特征数据与可视化展示，含谐波、噪声、频率等分析。
- **音源定位**：多种定位算法（TDOA、波束成形、MUSIC），支持实时/连续/触发追踪，空间定位图与检测统计。
- **模型训练**：深度学习模型（CNN、RNN、Transformer、ResNet）训练与监控，支持数据集选择、训练参数配置、训练进度与指标可视化，模型管理与资源监控。
- **性能分析**：系统 CPU、内存、磁盘、网络等性能监控，瓶颈分析与优化建议，活跃服务与趋势分析。
- **用户管理**：多角色（管理员、操作员、查看者）权限分级，用户增删改查、状态统计、权限说明。
- **问题反馈**：支持 Bug、功能建议、改进建议等反馈收集与处理，状态跟踪与优先级管理。
- **系统设置**：界面主题、语言、音频参数、安全策略、通知、数据库、网络等多项系统配置。

## 技术栈

- **前端框架**：React 18 + Vite 5
- **语言**：TypeScript
- **UI 组件**：shadcn/ui、Radix UI、Tailwind CSS
- **数据管理**：@tanstack/react-query
- **表单校验**：react-hook-form、zod
- **图表与可视化**：recharts
- **路由管理**：react-router-dom
- **图标库**：lucide-react
- **动画与交互**：tailwindcss-animate、sonner
- **其他**：date-fns、embla-carousel-react 等

## 安装与启动

1. **克隆项目**

```bash
git clone <your-repo-url>
cd sonic-insight-studio-main
```

2. **安装依赖**

```bash
npm install
# 或者使用 yarn
# yarn install
```

3. **本地开发启动**

```bash
npm run dev
# 或 yarn dev
```

4. **生产环境构建**

```bash
npm run build
# 或 yarn build
```

5. **预览构建结果**

```bash
npm run preview
```

## 目录结构

```
sonic-insight-studio-main/
├── public/                # 静态资源
├── src/
│   ├── components/        # 组件
│   │   ├── Auth/          # 认证与用户菜单
│   │   ├── Layout/        # 布局与侧边栏
│   │   ├── Modules/       # 各功能模块
│   │   └── ui/            # 通用UI组件
│   ├── contexts/          # 全局上下文
│   ├── hooks/             # 自定义hooks
│   ├── lib/               # 工具库
│   ├── pages/             # 页面
│   └── main.tsx           # 入口文件
├── index.html             # HTML模板
├── package.json           # 依赖与脚本
└── ...
```

## 账号与权限说明

- **测试账号**（登录页可见）：
  - 管理员：admin@example.com / 123456
  - 操作员：operator@example.com / 123456
  - 查看者：viewer@example.com / 123456
- **权限分级**：
  - 查看者：仅可查看数据与状态
  - 操作员：可采集、处理、导出、执行任务
  - 管理员：拥有全部权限，包括用户与系统管理

## 依赖与脚本

- 依赖详见 `package.json`
- 常用脚本：
  - `npm run dev`：本地开发
  - `npm run build`：生产构建
  - `npm run preview`：本地预览
  - `npm run lint`：代码检查

## 其他说明

- 本项目为前端演示平台，部分功能为模拟数据或前端交互，实际生产环境需对接后端API。
- 如需二次开发或集成，请参考各模块源码及注释。

---

如有问题或建议，欢迎通过"问题反馈"模块提交。