Granty

System automatyzacji i zarządzania procesem aplikowania o granty i dofinansowania.

O projekcie

Repozytorium zawiera narzędzia wspierające proces przygotowywania, składania i monitorowania wniosków grantowych. Projekt ma na celu uproszczenie "klepania grantów" poprzez automatyzację powtarzalnych zadań i centralizację dokumentacji.

Stack technologiczny

(unverified — confirm with team)

• Backend: Python 3.10+ / Node.js 18+
• Database: PostgreSQL / SQLite
• API: REST / FastAPI
• Frontend: React / Vue.js (jeśli aplikuje)
• Document generation: python-docx, reportlab, jinja2
• Task automation: Celery / node-cron

Funkcjonalności

(unverified — confirm with team — verify against actual codebase)

Zarządzanie wnioskami

• Rejestr złożonych i planowanych wniosków
• Tracking statusów (draft / submitted / accepted / rejected)
• Historia aplikacji z notes/outcomes

Generowanie dokumentacji

• Szablony wniosków (DOCX, PDF, ODT)
• Automatyczne wypełnianie danych z profilu organizacji
• Walidacja kompletności przed submitem

Baza programów grantowych

• Katalog dostępnych programów (NFOŚiGW, PARP, NCBiR, EU funds)
• Filtrowanie po branży, deadline, wysokości dofinansowania
• Alerty o zbliżających się deadlines

Integrations

• Scraping ogłoszeń z portali grantowych
• Export do formatów wymaganych przez grantodawców
• Backup dokumentacji (Google Drive / S3)

Instalacja i uruchomienie

Wymagania

(unverified — confirm with team)

# Python
python >= 3.10
pip >= 23.0

# Node.js (jeśli dotyczy)
node >= 18.0
npm >= 9.0

Setup lokalny

# Clone repository
git clone https://github.com/Wellysa/granty.git
cd granty

# Install dependencies (Python example)
pip install -r requirements.txt

# Setup database
python manage.py migrate  # lub inny init script

# Run development server
python main.py  # lub npm run dev, jeśli Node

Konfiguracja

Skopiuj .env.example do .env i uzupełnij:

DATABASE_URL=postgresql://user:pass@localhost:5432/granty
SECRET_KEY=twoj-secret-key
API_GRANT_SOURCES=nfosgigw,parp,ncbr  # źródła do scrapingu

(unverified — confirm actual env variables with team)

Struktura projektu

granty/
├── src/              # kod źródłowy aplikacji
├── templates/        # szablony dokumentów (DOCX, PDF)
├── data/             # dane o programach grantowych (JSON/CSV)
├── scripts/          # utility scripts (scraping, backup)
├── tests/            # testy jednostkowe i integracyjne
└── docs/             # dokumentacja projektu

(unverified — confirm against actual repository structure)

Użycie

Dodawanie nowego wniosku

# Python API example (unverified)
from granty import GrantApplication

app = GrantApplication(
    program="NFOŚiGW Energia+",
    deadline="2026-06-30",
    amount=500000
)
app.generate_template()
app.save()

CLI (przykładowo)

# List dostępnych programów
granty list --filter deadline:2026

# Generate wniosek z template
granty generate --program="PARP-123" --output="wniosek.docx"

# Submit wniosek (jeśli integracja z API)
granty submit --id=42

(unverified — confirm CLI interface exists and verify commands)

Rozwój i contributing

Uruchamianie testów

# Python
pytest tests/

# Node.js
npm test

(unverified — confirm test framework)

Style guide

• Python: PEP 8, type hints, docstrings
• JavaScript: ESLint + Prettier
• Commit messages: Conventional Commits format

Roadmap

(unverified — confirm with product owner)

• [ ] Integracja z API zewnętrznych baz grantów
• [ ] Automatyczny reminder system (email/Slack)
• [ ] ML-powered matching: projekt → najlepsze programy
• [ ] Multi-tenant support (wiele organizacji w jednej instancji)
• [ ] Mobile app (React Native / Flutter)

Status projektu

Early development — projekt w fazie aktywnego rozwoju. API i struktura mogą ulegać zmianom.

Licencja

(unverified — confirm with team) — MIT / Proprietary

Kontakt

• Organizacja: Wellysa
• Repo: github.com/Wellysa/granty
• Issues: Zgłaszaj problemy przez GitHub Issues

---

Uwaga: Sekcje oznaczone jako (unverified) wymagają weryfikacji z rzeczywistym stanem kodu. README wygenerowano na podstawie nazwy i opisu repozytorium — dopasuj do faktycznej implementacji.