# songjiang-warehouse1

**Repository Path**: drm/songjiang-warehouse1

## Basic Information

- **Project Name**: songjiang-warehouse1
- **Description**: 松江库房1
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-19
- **Last Updated**: 2025-11-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 Web 前端项目

一个基于 Vite + React + MobX 的现代 Web 前端应用，专注于提供丰富的交互体验和视觉效果。

## 📱 项目架构

### 技术栈

- **前端框架**: React 18
- **状态管理**: MobX 6.x
- **构建工具**: Vite
- **UI 组件**: Ant Design
- **路由**: React Router
- **开发语言**: TypeScript
- **代码分割**: Loadable Components

### 项目结构

```
srcWeb/           # Web 前端应用
types/            # 全局类型定义
utils/            # 通用工具函数
public/           # 静态资源文件
```

## 🚀 快速开始

### 环境要求

- Node.js ≥ 16.0.0

### 安装依赖

```bash
# 安装所有依赖
npm install
```

### 开发启动

```bash
# 启动 Web 开发服务器
npm run dev
```

### 生产构建

```bash
# Web 生产构建
npm run build
```

### 类型检查

```bash
# 运行 TypeScript 类型检查
npm run type-check
```

## 📋 可用脚本

| 命令                    | 说明                   |
| ----------------------- | ---------------------- |
| `npm run dev`         | Web 开发服务器         |
| `npm run build`       | Web 生产构建           |
| `npm run type-check`  | TypeScript 类型检查    |

## 🔧 开发规范

### 代码规范

- 使用 TypeScript 严格模式
- 遵循 React 最佳实践
- 组件化开发，提高代码复用率

### 项目功能模块

1. **首页展示**: 项目主页和入口
2. **UI组件展示**: UI组件的示例和用法
3. **3D渲染演示**: 使用Three.js进行3D渲染
4. **物理引擎演示**: 使用Cannon.js实现物理效果
5. **绘图功能**: 使用Fabric.js实现画布绘图
6. **Web3集成**: 区块链技术集成示例
7. **AI模型测试**: Ollama AI模型的测试界面

## 📚 技术文档

- [React 官方文档](https://react.dev/)
- [Vite 文档](https://vite.dev/guide/)
- [TypeScript 文档](https://www.typescriptlang.org/docs/)
- [Ant Design 组件库](https://ant.design/)
- [MobX 文档](https://mobx.js.org/)

## 📄 许可证

本项目采用 MIT 许可证。

---

<div align="center">
  <sub>Built with ❤️ using Vite + React + MobX + TypeScript</sub>
</div>