# promptMinder

**Repository Path**: 7n/promptMinder

## Basic Information

- **Project Name**: promptMinder
- **Description**: 一个专业的提示词的管理平台，让AI提示词管理更简单
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PromptMinder

一个现代化的 Prompt 管理和分享平台，基于 Next.js 构建。

## 🚀 快速开始

### 本地开发

```bash
# 安装依赖
npm install

# 配置环境变量
cp front/env.example front/.env.local

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

访问 http://localhost:3001

### 服务器部署

```bash
# 查看所有可用命令
npm run deploy -- help

# 在服务器上构建和部署
npm run deploy:build

# 查看应用状态
npm run deploy:status

# 查看日志
npm run deploy:logs
```

## 📁 项目结构

```
promptMinder/
├── front/                   # 前端代码
│   ├── app/                # Next.js 应用目录
│   ├── components/         # React 组件
│   ├── lib/               # 工具库
│   ├── public/            # 静态资源
│   ├── messages/          # 国际化文件
│   ├── hooks/             # React Hooks
│   ├── contexts/          # React Contexts
│   ├── package.json       # 前端依赖配置
│   ├── next.config.js     # Next.js 配置
│   ├── tailwind.config.js # Tailwind CSS 配置
│   └── ...
├── build/                  # 构建和部署相关
│   ├── scripts/           # 部署脚本
│   ├── sql/               # 数据库脚本
│   ├── Dockerfile         # Docker 配置
│   ├── docker-compose.yml # 本地开发 Docker 配置
│   ├── docker-compose.server.yml # 服务器部署配置
│   └── ...
├── package.json            # 项目根配置
└── README.md              # 项目文档
```

## 🛠️ 技术栈

- **前端**: Next.js 15, React 18, Tailwind CSS
- **后端**: Next.js API Routes
- **数据库**: PostgreSQL
- **认证**: NextAuth.js
- **部署**: Docker, Docker Compose
- **AI**: 智谱 AI API

## 🔧 环境配置

### 必需环境变量

在 `front/.env.local` 文件中配置：

```bash
# 数据库配置
DB_HOST=your-db-host
DB_PORT=5432
DB_NAME=promptminder
DB_USER=your-username
DB_PASSWORD=your-password

# NextAuth.js 配置
NEXTAUTH_SECRET=your-secret-key
NEXTAUTH_URL=http://localhost:3001

# 应用配置
NEXT_PUBLIC_BASE_URL=http://localhost:3001
```

### 可选环境变量

```bash
# AI API 配置
ZHIPU_API_KEY=your-zhipu-api-key
```

## 📦 部署

### 本地 Docker 部署

```bash
# 构建镜像
npm run docker:build

# 启动容器
npm run docker:up

# 停止容器
npm run docker:down
```

### 服务器部署

```bash
# 一键部署
npm run deploy:build

# 管理应用
npm run deploy -- start    # 启动
npm run deploy -- stop     # 停止
npm run deploy -- restart  # 重启
npm run deploy -- logs     # 查看日志
npm run deploy -- status   # 查看状态
```

## 🔍 故障排除

### 常见问题

1. **端口被占用**
   ```bash
   lsof -i :3001
   kill -9 <PID>
   ```

2. **数据库连接失败**
   ```bash
   # 测试连接
   psql -h your-db-host -U your-username -d promptminder
   ```

3. **Docker 构建失败**
   ```bash
   # 清理缓存
   docker system prune -f
   docker builder prune -f
   ```

### 获取帮助

```bash
# 查看部署脚本帮助
npm run deploy -- help

# 测试服务器连接
npm run deploy -- test
```

## 📚 文档

- [服务器部署指南](build/SERVER-DEPLOYMENT.md)
- [Docker Compose 问题解决](build/DOCKER-COMPOSE-FIX.md)
- [服务器构建指南](build/SERVER-BUILD-GUIDE.md)

## 🤝 贡献

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

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