# AICortex

**Repository Path**: inl-club/aicortex

## Basic Information

- **Project Name**: AICortex
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AICortex Monorepo

这是一个基于 pnpm workspaces 的 monorepo 项目架构。

## 项目结构

```
AICortex/
├── apps/
│   ├── web/       # 前端应用 (Vite + React)
│   └── api/       # 后端应用 (NestJS)
├── packages/      # 共享包目录
├── share/         # 共享资源目录
└── package.json   # 根配置文件
```

## 技术栈

### 前端 (apps/web)
- **框架**: React 18
- **构建工具**: Vite 5
- **语言**: TypeScript
- **端口**: 3000

### 后端 (apps/api)
- **框架**: NestJS 10
- **语言**: TypeScript
- **端口**: 3001
- **测试**: Jest

### 基础设施
- **包管理器**: pnpm
- **工作区**: pnpm workspaces
- **TypeScript**: 类型支持

## 快速开始

### 安装依赖

```bash
pnpm install
```

### 开发

```bash
# 运行所有应用的开发模式
pnpm dev

# 运行前端应用 (http://localhost:3000)
pnpm dev:web

# 运行后端应用 (http://localhost:3001)
pnpm dev:api

# 运行特定应用
pnpm --filter @aicortex/web dev
pnpm --filter @aicortex/api dev
```

### 构建

```bash
# 构建所有应用
pnpm build

# 构建前端应用
pnpm build:web

# 构建后端应用
pnpm build:api
```

### 测试

```bash
# 测试后端应用
pnpm test:api

# 运行所有测试
pnpm test
```

### 清理

```bash
pnpm clean
```

## 工作区说明

- **apps/web**: 前端应用，使用 Vite + React + TypeScript
- **apps/api**: 后端应用，使用 NestJS + TypeScript
- **packages/**: 存放可复用的共享包
- **share/**: 存放共享资源（配置、工具等）

## 应用说明

### 前端应用 (apps/web)

基于 Vite + React 的现代化前端应用。

**启动开发服务器**:
```bash
cd apps/web
pnpm dev
```

访问 http://localhost:3000

### 后端应用 (apps/api)

基于 NestJS 的 RESTful API 服务器。

**启动开发服务器**:
```bash
cd apps/api
pnpm dev
```

访问 http://localhost:3001

**API 端点**:
- `GET /` - 欢迎信息
- `GET /health` - 健康检查

## 添加新应用

1. 在 `apps/` 目录下创建新目录
2. 创建 `package.json` 文件
3. 在根目录运行 `pnpm install` 安装依赖

## 添加新包

1. 在 `packages/` 目录下创建新目录
2. 创建 `package.json` 文件
3. 在根目录运行 `pnpm install` 安装依赖

## 注意事项

- 确保 Node.js 版本 >= 18.0.0
- 确保 pnpm 版本 >= 8.0.0
- 使用 `pnpm` 而不是 `npm` 或 `yarn` 来管理依赖