Безплатна – open source
Функционалности
Основни модули
| Модул | Описание |
|---|---|
| Организации | Multi-tenant архитектура с роли (Admin, Manager, Member) |
| Контрагенти | Клиенти и доставчици с VIES валидация на ДДС номера |
| Фактури | Продажби и покупки с автоматично осчетоводяване |
| ДДС | Дневници за покупки/продажби, ДДС декларации |
| Счетоводство | Сметкоплан, дневникови записи, оборотни ведомости |
| Банки | Банкови сметки, транзакции, импорт на извлечения |
| Склад | Продукти, складове, наличности |
| ДМА | Дълготрайни материални активи с амортизации |
| Рецепти | Производствени рецепти за калкулация |
AI функционалности
| Функция | Описание |
|---|---|
| AI Фактури | Автоматично разпознаване на фактури с Azure Document Intelligence |
| OCR обработка | Извличане на данни от PDF документи |
Настройки на организацията
| Настройка | Описание |
|---|---|
| SMTP | Конфигурация на email сървър |
| Azure AI | API ключове за Document Intelligence |
| Сметки по подразбиране | Клиенти, Доставчици, ДДС, Приходи, Каса, Банка |
Технологии
Backend
- FastAPI – Модерен Python web framework
- SQLModel – ORM базиран на SQLAlchemy и Pydantic
- PostgreSQL – Релационна база данни
- Alembic – Миграции на базата данни
- JWT – Автентикация с токени
Frontend
- React 18 – UI библиотека
- TypeScript – Type-safe JavaScript
- Vite – Build tool
- Chakra UI – Компонентна библиотека
- TanStack Query – Data fetching
- React Hook Form – Форми
- i18next – Интернационализация (BG/EN)
DevOps
- Docker & Docker Compose – Контейнеризация
- Traefik – Reverse proxy с автоматични HTTPS сертификати
- GitHub Actions – CI/CD
Структура на проекта
barasurya/
├── backend/ # FastAPI backend
│ ├── app/
│ │ ├── api/ # API endpoints
│ │ ├── crud/ # Database operations
│ │ ├── models/ # SQLModel модели
│ │ ├── alembic/ # Миграции
│ │ └── services/ # Бизнес логика
│ └── scripts/ # Помощни скриптове
├── frontend/ # React frontend
│ ├── src/
│ │ ├── components/ # React компоненти
│ │ ├── routes/ # Страници
│ │ ├── client/ # Auto-generated API client
│ │ └── i18n/ # Преводи
│ └── public/ # Статични файлове
├── docs/ # Документация
├── docker-compose.yml # Production setup
├── docker-compose.override.yml # Development setup
└── .env.example # Примерна конфигурация
Документация
- Разработка – Настройка на development среда
- Backend – Backend документация
- Frontend – Frontend документация
- Deployment – Инструкции за deploy
- Multi-tenant архитектура
- ДДС модул – Българско ДДС
- Текущо състояние – Какво е реализирано
Принос към проекта
Приветстваме приноса към проекта!
- Fork-нете репозиторията
- Създайте feature branch (
git checkout -b feature/nova-funkcionalnost) - Commit-нете промените (
git commit -m 'Добавяне на нова функционалност') - Push-нете към branch-а (
git push origin feature/nova-funkcionalnost) - Отворете Pull Request
Repository: https://github.com/katehonz/barasurya-BG
Website: https://cyberbuch.org/
