# Flask NEO Object Storage Manager

🚀 A modern Flask web application for managing [BiznetGio NEO Object Storage](https://www.biznetgio.com/product/neo-object-storage) with S3-compatible API.

![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)
![Flask](https://img.shields.io/badge/Flask-2.3+-green.svg)
![License](https://img.shields.io/badge/License-MIT-yellow.svg)

## ✨ Features

- 📁 **File Upload & Management** - Upload files with drag & drop support
- 🖼️ **Image Preview** - Preview uploaded images directly in browser
- 🗑️ **File Deletion** - Delete files with confirmation
- 🔗 **Direct Links** - Copy direct URLs to clipboard
- 🛡️ **SSL Handling** - Automatic SSL certificate handling for development
- 🪣 **Auto Bucket Creation** - Automatically creates buckets if they don't exist
- 📱 **Responsive UI** - Bootstrap-based responsive interface
- 🔧 **Easy Configuration** - Environment variable based setup

## 🚀 Quick Start

### Prerequisites
- Python 3.8+
- BiznetGio NEO Object Storage account
- Access Key & Secret Key from NEO Portal

### Installation

1. **Clone the repository**
   ```bash
   git clone https://git.classy.id/andri/flask-neo-object-storage.git
   cd flask-neo-object-storage
   ```

2. **Create virtual environment**
   ```bash
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   ```

3. **Install dependencies**
   ```bash
   pip install -r requirements.txt
   ```

4. **Configure environment variables**
   ```bash
   cp .env.example .env
   # Edit .env with your NEO credentials
   ```

5. **Run the application**
   ```bash
   python app.py
   ```

6. **Open browser**
   ```
   http://localhost:7600
   ```

## ⚙️ Configuration

Create a `.env` file with your NEO Object Storage credentials:

```env
NEO_ACCESS_KEY=your_access_key_here
NEO_SECRET_KEY=your_secret_key_here
NEO_ENDPOINT=https://nos.wjv-1.neo.id
NEO_BUCKET=my-unique-bucket-name
NEO_USE_SSL=false
```

### Getting NEO Credentials

1. Login to [BiznetGio Portal](https://portal.biznetgio.com/)
2. Navigate to **NEO Object Storage**
3. Create a new bucket or use existing one
4. Copy your **Access Key** and **Secret Key**

## 📁 Project Structure

```
flask-neo-object-storage/
├── app.py                 # Main Flask application
├── requirements.txt       # Python dependencies
├── .env.example          # Environment variables template
├── .env                  # Your environment variables (gitignored)
├── templates/            # HTML templates
│   ├── base.html
│   ├── index.html
│   ├── upload.html
│   └── files.html
└── README.md
```

## 🛠️ API Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| `GET` | `/` | Home page |
| `GET/POST` | `/upload` | Upload files |
| `GET` | `/files` | View all files |
| `POST` | `/api/upload` | AJAX file upload |
| `POST` | `/api/delete` | Delete file |
| `GET` | `/api/files` | List files JSON |
| `GET` | `/test-connection` | Test NEO connection |
| `GET` | `/setup-bucket` | Create bucket |

## 🐛 Troubleshooting

### SSL Certificate Issues
If you encounter SSL certificate errors:
```env
NEO_USE_SSL=false
NEO_ENDPOINT=http://nos.wjv-1.neo.id
```

### Bucket Not Found Error
1. Make sure bucket name is unique globally
2. Create bucket manually in NEO Portal
3. Use `/setup-bucket` endpoint to auto-create

### Access Denied Error
1. Verify your Access Key and Secret Key
2. Check bucket permissions in NEO Portal
3. Ensure bucket policy allows public read

## 🚀 Deployment

### Production Deployment

1. **Use production WSGI server**
   ```bash
   pip install gunicorn
   gunicorn -w 4 -b 0.0.0.0:8000 app:app
   ```

2. **Enable SSL in production**
   ```env
   NEO_USE_SSL=true
   ```

3. **Use reverse proxy (Nginx)**
   ```nginx
   server {
       listen 80;
       server_name yourdomain.com;
       
       location / {
           proxy_pass http://127.0.0.1:8000;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
       }
   }
   ```

### Docker Deployment

```dockerfile
FROM python:3.9-slim

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .
EXPOSE 7600

CMD ["python", "app.py"]
```

## 🤝 Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- [BiznetGio](https://www.biznetgio.com/) for NEO Object Storage service
- [Flask](https://flask.palletsprojects.com/) web framework
- [Bootstrap](https://getbootstrap.com/) for UI components
- [Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) for AWS S3 compatible API

## 📞 Support

- 📧 Email: kontak@classy.id

---

**Made with ❤️ in Indonesia**


Dengan setup ini, kamu bisa menggunakan Flask app sebagai microservice untuk handle object storage, sementara aplikasi utama tetap menggunakan PHP!
```