432aa63e36
- Add Woodpecker pipeline with base image support - Separate base image build (.woodpecker-base.yml) from app build (.woodpecker.yml) - Implement build/push separation in application pipeline - Create Docker base image with Python 3.11, Node.js 20, and bun - Update Dockerfile to use pre-built base image for faster builds - Remove GitHub Actions (not needed, using Woodpecker) - Fix Docker contexts and paths for new structure - Update docker-compose.yml build contexts - Fix rxconfig.py DB path for container environment - Add ArgoCD application manifests for staging/production - Create comprehensive documentation: - docs/WOODPECKER_CI_CD.md (CI/CD guide) - docs/BASE_IMAGE_MANAGEMENT.md (Base image management) - helm/peikarband/argocd/README.md (ArgoCD deployment) Benefits: - Build time: 8-10min → 2-3min (60-70% faster) - Better reliability (no repeated npm/bun downloads) - Separation of concerns (base vs application builds) - Full pipeline: check → build → push → verify → notify - Complete deployment automation with Helm + ArgoCD Pipeline stages: 1. check-base-image: Verify base image availability 2. build-image: Build application (no push) 3. push-image: Push with multi-tags (latest, sha, branch) 4. verify-push: Verify successful push 5. notify: Success/failure notifications Base image can be rebuilt via: - Manual trigger in Woodpecker UI - Auto trigger when Dockerfile.base changes
پیکربند - پلتفرم جامع مدیریت هاستینگ و زیرساخت ابری
📖 درباره پروژه
پیکربند یک پلتفرم حرفهای برای مدیریت هاستینگ، سرورهای ابری، دامین و خدمات DevOps است. این پلتفرم با الهام از سرویسهایی مانند Cloudways، DigitalOcean و پارس پک طراحی شده است.
🏗️ معماری
این پروژه بر اساس Clean Architecture و اصول SOLID طراحی شده است:
- Domain Layer: منطق کسبوکار اصلی
- Application Layer: موارد استفاده (Use Cases)
- Infrastructure Layer: پیادهسازیهای فنی
- Presentation Layer: رابط کاربری (Reflex)
🚀 تکنولوژیها
- Frontend/Backend: Python Reflex
- Database: PostgreSQL + SQLAlchemy
- Cache: Redis
- Task Queue: Celery
- Testing: pytest
- Code Quality: black, flake8, mypy, isort
📋 پیشنیازها
- Python 3.11+
- PostgreSQL 14+
- Redis 7+
- Node.js 18+ (برای Reflex)
🛠️ نصب و راهاندازی
1. کلون کردن پروژه
git clone https://github.com/yourusername/peikarband.git
cd peikarband
2. ایجاد محیط مجازی
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
3. نصب وابستگیها
pip install -r requirements.txt
pip install -r requirements-dev.txt # برای توسعه
4. تنظیم Environment Variables
cp .env.example .env
# ویرایش .env و تکمیل مقادیر
5. راهاندازی دیتابیس
# ایجاد دیتابیس
createdb peikarband
# اجرای migrations
alembic upgrade head
6. اجرای پروژه
# توسعه
python -m reflex run
# یا
make dev
🚢 Deployment
با Docker
# Build
docker build -t peikarband:latest .
# Run
docker-compose up -d
با Kubernetes/Helm
# Deploy
helm upgrade --install peikarband ./deploy/helm/peikarband \
--namespace production \
--set image.tag=0.1.0
# یا
make k8s-deploy
📁 ساختار پروژه
peikarband-landing/
├── build/ # Build configs (Docker, CI/CD)
├── deploy/ # Deployment configs (Helm, K8s, ArgoCD)
├── config/ # Configuration files
├── tools/ # Scripts و ابزارها
├── assets/ # Static assets
├── src/ # Source code (Clean Architecture)
│ ├── config/ # تنظیمات
│ ├── core/ # هسته اصلی (Domain + Application)
│ ├── infrastructure/ # پیادهسازیهای فنی
│ ├── presentation/ # رابط کاربری (Reflex)
│ └── shared/ # کدهای مشترک
├── tests/ # تستها
├── docs/ # مستندات کامل
└── data/ # Local data (gitignored)
🧪 تست
# اجرای همه تستها
pytest
# با coverage
pytest --cov=src tests/
# تستهای خاص
pytest tests/unit/
pytest tests/integration/
📝 کدنویسی
استانداردها
- PEP 8: استاندارد کدنویسی Python
- PEP 20: Zen of Python
- Type Hints: همه جا استفاده شود
- Docstrings: Google Style
ابزارهای کیفیت کد
# Format
black src/
# Linting
flake8 src/
# Type checking
mypy src/
# Import sorting
isort src/
Pre-commit Hooks
pre-commit install
pre-commit run --all-files
📚 مستندات
مستندات کامل در پوشه docs/ موجود است:
- Handbook: راهنمای جامع پروژه
- Architecture: معماری سیستم
- Development: راهنمای توسعه
- API Reference: مستندات API
🔐 امنیت
- همه پسوردها با bcrypt hash میشوند
- استفاده از JWT برای authentication
- پشتیبانی از 2FA
- اطلاعات حساس رمزنگاری میشوند
🤝 مشارکت
برای مشارکت در پروژه:
- Fork کنید
- Branch جدید بسازید (
git checkout -b feature/amazing-feature) - Commit کنید (
git commit -m 'feat: add amazing feature') - Push کنید (
git push origin feature/amazing-feature) - Pull Request بسازید
📄 لایسنس
این پروژه تحت لایسنس MIT منتشر شده است.
👥 تیم
- Lead Developer: [Your Name]
- Architecture: Clean Architecture
- Methodology: Agile/Scrum
📞 تماس
- Website: https://peikarband.ir
- Email: support@peikarband.ir
- Telegram: @peikarband
نسخه: 0.1.0
آخرین بروزرسانی: 2025-01-24