feat: init

Author: ccrvlh

.env.example

@@ -0,0 +1,22 @@
+# API Server Configuration
+RQM_APP_HOST=0.0.0.0
+RQM_APP_PORT=8000
+RQM_APP_NGINX_PORT=7777
+RQM_APP_DEBUG=false
+RQM_APP_RELOAD=false
+RQM_APP_LOG_LEVEL=INFO
+
+# Redis Configuration
+RQM_APP_REDIS_HOST=localhost
+RQM_APP_REDIS_PORT=6379
+RQM_APP_REDIS_DB=0
+RQM_APP_REDIS_PASSWORD=
+RQM_APP_REDIS_URL=
+RQM_APP_REDIS_SSL=false
+RQM_APP_REDIS_TIMEOUT=5
+
+# Analytics Configuration
+RQM_APP_ANALYTICS_ENABLED=true
+RQM_APP_ANALYTICS_DB_PATH=data/analytics.db
+RQM_APP_ANALYTICS_COLLECTION_INTERVAL=1
+RQM_APP_ANALYTICS_RETENTION_DAYS=7

.github/workflows/docker.yml

@@ -0,0 +1,50 @@
+name: Build and Push Docker Image
+
+on:
+  push:
+    branches: [ main ]
+    tags: [ 'v*' ]
+  pull_request:
+    branches: [ main ]
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Log in to Container Registry
+      uses: docker/login-action@v3
+      with:
+        registry: ${{ env.REGISTRY }}
+        username: ${{ github.actor }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Extract metadata
+      id: meta
+      uses: docker/metadata-action@v5
+      with:
+        images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+        tags: |
+          type=ref,event=branch
+          type=ref,event=pr
+          type=semver,pattern={{version}}
+          type=semver,pattern={{major}}.{{minor}}
+          type=raw,value=latest,enable={{is_default_branch}}
+
+    - name: Build and push Docker image
+      uses: docker/build-push-action@v5
+      with:
+        context: .
+        push: true
+        tags: ${{ steps.meta.outputs.tags }}
+        labels: ${{ steps.meta.outputs.labels }}

.gitignore

@@ -0,0 +1,18 @@
+__pycache__
+**/__pycache__
+__pycache__/
+**/__pycache__/
+*.py[cod]
+**/.mypy_cache/
+.refs/
+.mypy_cache/
+.local/
+.vscode/
+api/.venv
+front/node_modules
+front/dist
+**/.env
+settings.toml
+**/analytics.db
+**/*.tsbuildinfo
+*.DS_Store

CONTRIBUTING.md

@@ -0,0 +1,104 @@
+# Contributing to RQ Manager
+
+Thank you for your interest in contributing to RQ Manager! This guide will help you get started with development and contributing to the project.
+
+## 🔧 Development
+
+### Project Structure
+
+```
+rq-manager/
+├── api/                    # Python backend
+│   ├── app/
+│   │   ├── routes/        # API endpoints
+│   │   ├── services/      # Business logic
+│   │   ├── schemas/       # Data models
+│   │   └── cli/           # CLI commands
+│   └── pyproject.toml     # Python dependencies
+├── front/                 # React frontend
+│   ├── src/
+│   │   ├── pages/         # UI pages
+│   │   ├── services/      # API clients
+│   │   └── utils/         # Utilities
+│   └── package.json       # Node dependencies
+├── infra/                 # Infrastructure
+│   ├── k8s/              # Kubernetes manifests
+│   └── nginx/            # Nginx configuration
+└── docs/                 # Documentation
+```
+
+### Local Development Setup
+
+#### Backend Setup
+
+```bash
+# Navigate to API directory
+cd api
+
+# Install Poetry (if not already installed)
+pip install poetry
+
+# Install dependencies
+poetry install
+
+# Copy and configure environment
+cp ../.env.example .env
+# Edit .env with your configuration
+
+# Run the API server
+poetry run rqm api --host 0.0.0.0 --port 8000
+```
+
+#### Frontend Setup
+
+```bash
+# Navigate to frontend directory
+cd front
+
+# Install dependencies
+yarn install
+
+# Copy environment configuration
+cp .env.example .env.local
+# Edit .env.local with your API endpoint
+
+# Start development server
+yarn dev
+```
+
+## Performance Considerations
+
+- Profile code changes for performance impact
+- Use appropriate data structures and algorithms
+- Consider memory usage for large datasets
+- Optimize database queries and Redis operations
+
+## Security Guidelines
+
+- Never commit secrets or credentials
+- Validate all user inputs
+- Use parameterized queries for database operations
+- Follow OWASP security guidelines
+- Review dependencies for known vulnerabilities
+
+## Documentation
+
+- Update README.md for user-facing changes
+- Add inline code comments for complex logic
+- Update API documentation for endpoint changes
+- Include examples in documentation
+
+## Getting Help
+
+- **Issues**: [GitHub Issues](https://github.com/ccrvlh/rq-manager/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/ccrvlh/rq-manager/discussions)
+- **Documentation**: [Wiki](https://github.com/ccrvlh/rq-manager/wiki)
+
+## Release Process
+
+1. Update version numbers in `pyproject.toml` and `package.json`
+2. Update CHANGELOG.md with new features and fixes
+3. Create a release branch
+4. Run full test suite
+5. Create a pull request for review
+6. Tag the release after merge

Dockerfile

@@ -0,0 +1,50 @@
+ARG FRONTEND_ENV=docker
+
+FROM python:3.12-slim AS api-build
+
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app/api
+COPY api/poetry.lock api/pyproject.toml ./
+RUN pip install poetry
+RUN poetry config virtualenvs.create false
+RUN poetry install --without dev --no-cache --no-root
+COPY api/ ./
+
+FROM node:20-alpine AS frontend-build
+
+ARG FRONTEND_ENV
+WORKDIR /app/front
+COPY front/package*.json ./
+COPY front/yarn.lock ./
+RUN yarn install --frozen-lockfile
+COPY front/ ./
+COPY front/.env.${FRONTEND_ENV} .env
+RUN yarn build
+
+FROM python:3.12-slim AS production
+
+RUN apt-get update && apt-get install -y \
+    nginx \
+    curl \
+    gettext-base \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+COPY --from=api-build /usr/local /usr/local
+COPY --from=api-build /app/api /app/api
+COPY --from=frontend-build /app/front/dist /usr/share/nginx/html
+COPY infra/nginx/nginx.conf.template /etc/nginx/nginx.conf.template
+COPY startup.sh /startup.sh
+RUN chmod +x /startup.sh
+
+EXPOSE 7777
+
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:7777/health || exit 1
+
+CMD ["/startup.sh"]