refactor: directory structure adjustment and optimization

Author: Daymychen

.env

@@ -1,7 +1,7 @@
 # 【通用】环境变量
 
 #  版本号
-VITE_VERSION = 2.6.1
+VITE_VERSION = 3.0.0
 
 # 端口号
 VITE_PORT = 3006

CHANGELOG.md

@@ -6,6 +6,45 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Released]
 
+### v3.0.0 - 2025-11-09 🎉
+
+#### Refactored
+
+- Style system refactored: Sass fully migrated to Tailwind CSS, improving development efficiency and style consistency
+- Icon solution upgraded: Iconfont replaced with Iconify, supporting richer icon libraries and on-demand loading
+- Route registration refactored: Comprehensive refactoring of route registration system with object-oriented design, improving code maintainability, testability and extensibility
+- Refactored ArtTextScroll component, improving performance and maintainability
+- Refactored color system, unified UI visual specifications, improving interface consistency
+
+#### Optimized
+
+- Build optimization: Complete package size reduced by 1.3 MB, significantly improving loading performance
+- Architecture optimization: Optimized directory structure with clearer responsibility division, reducing user learning curve and onboarding difficulty
+- Comment optimization: Unified module comment standards, improved component descriptions, feature explanations and usage examples, reducing user understanding cost and onboarding difficulty
+- Performance improvement: Optimized core code logic, improving system runtime efficiency
+- Menu optimization: Refined menu styles, optimized interaction experience and visual presentation
+- Responsive optimization: Optimized ArtForm and ArtSearchBar grid layout, adapting to various screen sizes
+- Configuration management optimization: Added setting.ts configuration file, supporting one-click copy and reset of system default settings
+
+#### Fixed
+
+- Fixed ArtForm and ArtSearchBar custom component rendering issues
+
+#### Added
+
+- ArtForm and ArtSearchBar added render property, supporting custom component rendering
+- Festival feature enhancement: Fireworks configuration supports cross-date range settings and custom playback counts
+
+#### Upgraded
+
+- Dependency updates: Upgraded core dependencies to latest stable versions
+
+#### ⚠️ Important Notice
+
+> This upgrade involves fundamental refactoring of the style system (Sass → Tailwind CSS) and icon library (Iconfont → Iconify), which is a breaking change. It is recommended to use v3.0 for new projects. Upgrading existing projects is not recommended.
+
+---
+
 ### v2.6.1 - 2025-10-19
 
 #### Fixed

CHANGELOG.zh-CN.md

@@ -6,6 +6,45 @@
 
 ## [已发布]
 
+### v3.0.0 - 2025-11-09 🎉
+
+#### 重构
+
+- 样式系统重构：Sass 全面迁移至 Tailwind CSS，提升开发效率与样式一致性
+- 图标方案升级：Iconfont 替换为 Iconify，支持更丰富的图标库与按需加载
+- 路由注册重构：全面重构路由注册系统，引入面向对象设计，提高代码的可维护性、可测试性和扩展能力
+- 重构 ArtTextScroll 组件，提升性能与可维护性
+- 重构颜色体系，统一 UI 视觉规范，提升界面一致性
+
+#### 优化
+
+- 构建优化：完整包体积减少 1.3 MB，显著提升加载性能
+- 架构优化：优化目录结构，职责划分更清晰，降低用户学习成本与上手难度
+- 注释优化：统一模块注释规范，完善每一个组件介绍、功能说明与使用示例，降低用户理解成本与上手难度
+- 性能提升：优化核心代码逻辑，提升系统运行效率
+- 菜单优化：细化菜单样式，优化交互体验与视觉呈现
+- 响应式优化：优化 ArtForm、ArtSearchBar 栅格布局，适配多种屏幕尺寸
+- 配置管理优化：新增 setting.ts 配置文件，支持一键复制与重置系统默认设置
+
+#### 修复
+
+- 修复 ArtForm、ArtSearchBar 自定义组件渲染异常
+
+#### 新增
+
+- ArtForm、ArtSearchBar 新增 render 属性，支持自定义组件渲染
+- 节日功能增强：礼花配置支持跨日期范围设置与自定义播放次数
+
+#### 升级
+
+- 依赖更新：升级核心依赖至最新稳定版本
+
+#### ⚠️ 重要提示
+
+> 本次升级涉及样式系统（Sass → Tailwind CSS）与图标库（Iconfont → Iconify）的底层重构，属于破坏性更新。建议新项目直接使用 v3.0，旧版本项目不建议升级。
+
+---
+
 ### v2.6.1 - 2025-10-19
 
 #### 修复

src/App.vue

@@ -9,9 +9,9 @@
   import zh from 'element-plus/es/locale/lang/zh-cn'
   import en from 'element-plus/es/locale/lang/en'
   import { systemUpgrade } from './utils/sys'
-
-  import { setThemeTransitionClass } from './utils/ui/animation'
+  import { toggleTransition } from './utils/ui/animation'
   import { checkStorageCompatibility } from './utils/storage'
+  import { initializeTheme } from './hooks/core/useTheme'
 
   const userStore = useUserStore()
   const { language } = storeToRefs(userStore)
@@ -22,15 +22,13 @@
   }
 
   onBeforeMount(() => {
-    setThemeTransitionClass(true)
+    toggleTransition(true)
+    initializeTheme()
   })
 
   onMounted(() => {
-    // 检查存储兼容性
     checkStorageCompatibility()
-    // 提升暗黑主题下页面刷新视觉体验
-    setThemeTransitionClass(false)
-    // 系统升级
+    toggleTransition(false)
     systemUpgrade()
   })
 </script>

…mponents/custom/comment-widget/index.vue …onents/business/comment-widget/index.vuesrc/components/custom/comment-widget/index.vue renamed to src/components/business/comment-widget/index.vue src/components/custom/comment-widget/index.vue renamed to src/components/business/comment-widget/index.vue

@@ -19,7 +19,7 @@
 </template>
 
 <script setup lang="ts">
-  import { useCommon } from '@/composables/useCommon'
+  import { useCommon } from '@/hooks/core/useCommon'
 
   defineOptions({ name: 'ArtBackToTop' })
 

…om/comment-widget/widget/CommentItem.vue …ss/comment-widget/widget/CommentItem.vuesrc/components/custom/comment-widget/widget/CommentItem.vue renamed to src/components/business/comment-widget/widget/CommentItem.vue src/components/custom/comment-widget/widget/CommentItem.vue renamed to src/components/business/comment-widget/widget/CommentItem.vue

@@ -28,7 +28,7 @@
 </template>
 
 <script setup lang="ts">
-  import { useChartOps, useChartComponent } from '@/composables/useChart'
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
   import { type EChartsOption } from '@/plugins/echarts'
 
   defineOptions({ name: 'ArtBarChartCard' })

src/components/core/base/art-back-to-top/index.vue

@@ -40,7 +40,7 @@
 
 <script setup lang="ts">
   import { type EChartsOption } from '@/plugins/echarts'
-  import { useChartOps, useChartComponent } from '@/composables/useChart'
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
 
   defineOptions({ name: 'ArtDonutChartCard' })
 

src/components/core/cards/art-bar-chart-card/index.vue

@@ -33,7 +33,7 @@
 <script setup lang="ts">
   import { graphic, type EChartsOption } from '@/plugins/echarts'
   import { getCssVar, hexToRgba } from '@/utils/ui'
-  import { useChartOps, useChartComponent } from '@/composables/useChart'
+  import { useChartOps, useChartComponent } from '@/hooks/core/useChart'
 
   defineOptions({ name: 'ArtLineChartCard' })