BR Documentation Generator: Automatyzacja Ulgi B+R - Status Projektu Styczeń 2026

Generator dokumentacji dla polskiej ulgi B+R (Badania i Rozwój). Automatyczne tworzenie raportów zgodnych z wymogami KIS. Status: Active Development

2026-02-10 • Softreck

BR Documentation Generator

Status: 🔄 Active Development
Target Market: Polskie firmy IT korzystające z ulgi B+R
Framework: Python + AI/LLM

Co to jest BR Documentation Generator?

Narzędzie do automatycznego generowania dokumentacji wymaganej do skorzystania z polskiej ulgi podatkowej B+R (Badania i Rozwój). Generator analizuje kod źródłowy, commity Git i zadania z project management, tworząc kompletne raporty zgodne z wymogami Krajowej Informacji Skarbowej.

Problem

Polskie firmy IT mogą odliczyć nawet 200% kosztów kwalifikowanych w ramach ulgi B+R, ale:

  • Dokumentacja wymaga szczegółowego opisu działalności badawczo-rozwojowej
  • Każdy projekt musi mieć uzasadnienie innowacyjności
  • Raporty muszą być zgodne z interpretacjami KIS
  • Ręczne tworzenie dokumentacji zajmuje dziesiątki godzin

Rozwiązanie

# Instalacja
pip install br-generator


# Generowanie raportu dla projektu
br-generator analyze ./my-project --year 2025 --output raport-br.docx


# Z integracją Jira
br-generator analyze ./my-project \
  --jira-url https://company.atlassian.net \
  --jira-project PROJ \
  --year 2025

Funkcjonalności

Analiza Kodu

  • Parsowanie AST dla Python, JavaScript, TypeScript
  • Identyfikacja wzorców innowacyjnych (nowe algorytmy, optymalizacje)
  • Analiza złożoności kodu i metryki jakości

Integracje

  • Git: historia commitów, contributors, timeline
  • Jira/Linear: mapowanie tasków do prac B+R
  • GitHub: issues, PRs, code reviews

Generowanie Raportów

  • Format DOCX zgodny z wymogami KIS
  • Automatyczne uzasadnienia innowacyjności
  • Podsumowania dla księgowości

Status Komponentów

KomponentStatusUwagi
Git Analysis✅ StabilnyHistoria, contributors, timeline
AST Parser✅ StabilnyPython, JS, TS
Jira Integration⚠️ BetaPodstawowe mapowanie
DOCX Generator✅ StabilnyZgodny z KIS
LLM Summaries⚠️ BetaOpenRouter integration
Data Validation🔄 In ProgressWalidacja spójności danych

Wyzwania i Rozwiązania

Problem: Jakość Danych

Generowane raporty zawierały niespójności w datach i nazwach projektów.

Rozwiązanie: Implementacja comprehensive validation pipeline:

  • Cross-check dat między Git a Jira
  • Normalizacja nazw projektów
  • Automatyczne wykrywanie duplikatów

Problem: Uzasadnienia Innowacyjności

LLM generował zbyt ogólnikowe opisy.

Rozwiązanie: Fine-tuning promptów z przykładami zaakceptowanych wniosków B+R

Przykład Wygenerowanego Raportu

## Projekt: Algorytm Optymalizacji Cache


### Opis działalności B+R
Opracowanie nowatorskiego algorytmu cache'owania z wykorzystaniem 
predykcji dostępu opartej o analizę wzorców użytkowania...


### Innowacyjność
- Nowy algorytm predykcji (brak odpowiedników w literaturze)
- Redukcja miss rate o 34% vs LRU
- Patent pending (zgłoszenie nr XXX)


### Koszty kwalifikowane
- Wynagrodzenia: 156,000 PLN
- Sprzęt: 12,000 PLN
- Łącznie: 168,000 PLN


### Timeline
- Start: 2025-03-01
- Zakończenie: 2025-09-30
- Commits: 847
- Contributors: 4

Roadmap

Q1 2026

  • Ulepszony validation pipeline
  • Integracja z Linear
  • Panel webowy

Q2 2026

  • Automatyczna kategoryzacja kosztów
  • Eksport do systemów księgowych
  • Multi-company support

Linki

Ostatnia aktualizacja: 10 lutego 2026