0ad2ba0f02
ميزة: إضافة خدمة تحليلات لتكامل Google Analytics اختبار: تحديث اختبارات خدمة واجهة برمجة التطبيقات (API) لتعكس تغييرات نقاط النهاية إصلاح: تعديل خدمة واجهة برمجة التطبيقات (API) لدعم تحميل ملفات متعددة ومصادقة المستخدم ميزة: تطبيق مخزن مصادقة باستخدام Zustand لإدارة المستخدمين إصلاح: تحسين إعدادات Nginx لتعزيز الأمان ودعم التحليلات
98 lines
3.0 KiB
Markdown
98 lines
3.0 KiB
Markdown
# SaaS-PDF — Free Online Tools Platform
|
|
|
|
A free SaaS platform offering PDF, image, video, and text processing tools. Built with **Python Flask** (backend) and **React + Vite** (frontend), powered by **Celery + Redis** for async processing, and deployed on **AWS**.
|
|
|
|
## 🛠 Tools (Current)
|
|
|
|
1. **PDF Conversion** — PDF↔Word
|
|
2. **PDF Optimization** — Compress PDF
|
|
3. **PDF Utilities** — Merge, split, rotate, page numbers, watermark
|
|
4. **PDF Security** — Protect and unlock PDF
|
|
5. **PDF/Image Tools** — PDF→Images, Images→PDF
|
|
6. **Image Tools** — Convert and resize images
|
|
7. **Video Tools** — Video→GIF
|
|
8. **Text Tools** — Word counter and text cleaner
|
|
9. **Flowchart Tools** — Extract procedures from PDF and generate flowcharts (+ sample mode)
|
|
10. **Accounts & History** — Email/password sign-in with recent generated-file history
|
|
|
|
## 🏗 Tech Stack
|
|
|
|
| Layer | Technology |
|
|
|-------|-----------|
|
|
| Backend API | Python 3.12 + Flask 3.x |
|
|
| Task Queue | Celery 5.x + Redis |
|
|
| File Processing | LibreOffice, Ghostscript, Pillow, ffmpeg |
|
|
| Frontend | React 18 + Vite 5 + TypeScript |
|
|
| Styling | Tailwind CSS (RTL support) |
|
|
| i18n | react-i18next (Arabic + English + French) |
|
|
| Storage | AWS S3 (temp files with auto-cleanup) |
|
|
| CDN | AWS CloudFront |
|
|
| Server | AWS EC2 + Nginx |
|
|
|
|
## 🚀 Quick Start (Development)
|
|
|
|
```bash
|
|
# 1. Clone the repo
|
|
git clone https://github.com/aborayan2022/SaaS-PDF.git
|
|
cd SaaS-PDF
|
|
|
|
# 2. Copy environment file
|
|
cp .env.example .env
|
|
cp frontend/.env.example frontend/.env
|
|
|
|
# 3. Start all services with Docker
|
|
docker-compose up --build
|
|
|
|
# 4. Access the app
|
|
# Frontend: http://localhost:5173
|
|
# Backend API: http://localhost:5000/api
|
|
# Celery Flower: http://localhost:5555
|
|
```
|
|
|
|
## ⚙️ Runtime Limits (Default)
|
|
|
|
- File retention: **30 minutes** (`FILE_EXPIRY_SECONDS=1800`)
|
|
- PDF max size: **20MB**
|
|
- Word max size: **15MB**
|
|
- Image max size: **10MB**
|
|
- Video max size: **50MB**
|
|
|
|
## 🔐 Accounts & Sessions
|
|
|
|
- Session-backed authentication via `/api/auth/*`
|
|
- Free account creation with email + password
|
|
- Recent generated-file history via `/api/history`
|
|
- Persistent SQLite storage at `DATABASE_PATH` (defaults to `backend/data/saas_pdf.db` locally)
|
|
|
|
## 📈 Analytics & Ads Env
|
|
|
|
- `VITE_GA_MEASUREMENT_ID`
|
|
- `VITE_ADSENSE_CLIENT_ID`
|
|
- `VITE_ADSENSE_SLOT_HOME_TOP`
|
|
- `VITE_ADSENSE_SLOT_HOME_BOTTOM`
|
|
- `VITE_ADSENSE_SLOT_TOP_BANNER`
|
|
- `VITE_ADSENSE_SLOT_BOTTOM_BANNER`
|
|
- `DATABASE_PATH`
|
|
|
|
## 📁 Project Structure
|
|
|
|
```
|
|
SaaS-PDF/
|
|
├── backend/ # Flask API + Celery Workers
|
|
├── frontend/ # React + Vite + TypeScript
|
|
├── nginx/ # Reverse proxy configuration
|
|
├── scripts/ # Deployment & maintenance scripts
|
|
├── docs/ # Project documentation
|
|
├── docker-compose.yml
|
|
└── docker-compose.prod.yml
|
|
```
|
|
|
|
## 💰 Revenue Model
|
|
|
|
- **Google AdSense** — Ads on result/download pages
|
|
- **Freemium** (next phase) — Pro features: no ads, higher limits, API access
|
|
|
|
## 📄 License
|
|
|
|
MIT
|