Digital Sofia - Цифрова София

Платформа за електронни услуги на Столична община София, предназначена за предоставяне на удобни и достъпни електронни услуги на гражданите. В първата версия се поддържат две основни услуги:

• Плащане и справки за данъци
• Смяна на постоянен и настоящ адрес

‼️ Важно ‼️ Проекта е в състояние на затворена бета/closed beta.

Предстои надграждане с допълнителни фукнционалности за:

• автентикация с еАвт на eGov.bg https://eauth.egov.bg/eauth/ssologin
• допълнителни административни услуги
• известия за събития, ремонти и важни за града новини по локации
• и други, за които може да пишете в Отворения роудмап тук: https://github.com/orgs/sofia-municipality/projects/3/

✨ Основни функционалности

За граждани:

• 📱 Мобилно приложение за iOS и Android
• 🏠 Уеб портал за електронни услуги
• 🔐 Сигурна автентикация с Евротръст
• 📄 Подаване на заявления за смяна на адрес
• 📄 Проверка и плащане на данъци
• 📝 Проследяване на статуса на заявления и плащания
• 📋 Изтегляне на документи
• 💬 Контакти и поддръжка
• 🌍 Многоезична поддръжка (български/английски)

За администратори:

• 🔧 Административен панел
• 📊 Аналитика и отчети
• 📋 Управление на формуляри
• ⚙️ Конфигуриране на процеси
• 👥 Управление на потребители

🏗️ Архитектура

Системата използва модерна микросервисна архитектура с:

• Frontend: React.js със Single-SPA микро фронтенди
• Mobile: мобилни приложения за Android (Kotlin) и iOS (Swift)
• Backend: Python Flask API със Spring Boot Camunda
• Аутентикация: Keycloak за SSO и управление на потребители
• База данни: PostgreSQL
• Workflow: Camunda BPM Engine
• Аналитика: Redash за визуализация на данни
• Евротръст: Интеграция за електронни подписи и идентификация

📱 Компоненти на системата

Мобилни приложения

• digital-sofia-android/ - Android мобилно приложение (Kotlin, Clean Architecture)
• digital-sofia-ios/ - iOS мобилно приложение (Swift, SwiftUI)

Уеб платформа

• forms-flow-web/ - Основно уеб приложение (React.js 17.0.2)
• forms-flow-web-mf/ - Микро фронтенд модули
• forms-flow-web-mf-admin/ - Административен интерфейс
• forms-flow-web-mf-nav/ - Навигационни компоненти
• forms-flow-web-mf-service/ - Сервизни модули
• forms-flow-web-mf-theme/ - Теми и стилове
• forms-flow-web-root-config/ - Web конфигурация

Backend системи

• forms-flow-api/ - Основно API (Python, Flask 2.1.3)
• forms-flow-bpm/ - Workflow engine (Camunda 7.17.0, Spring Boot 2.6.6)
• forms-flow-analytics/ - Аналитика и отчети (Redash 10.1.4)
• forms-flow-data-analysis-api/ - API за анализ на данни
• forms-flow-documents/ - Документооборот
• forms-flow-forms/ - Форм.ио интеграция
• forms-flow-idm/ - Управление на идентичност (Keycloak)
• formsflow-admin-api/ - Административно API

Интеграции и разширения

• forms-flow-eforms-auditlog-client/ - Одит лог клиент
• forms-flow-eforms-idp-extensions/ - IDP разширения
• forms-flow-eforms-integrations/ - Е-форми интеграции
• forms-flow-eforms-signature-services/ - Услуги за подписване
• forms-flow-api-utils/ - API утилити
• forms-flow-mail-templates/ - Шаблони за имейли

⚡ Бърз старт

‼️ Важно ‼️ Наличния сорс код все още не е в състояние за пълноценно стартиране и разработка в Дев среда. Липсват основни конфигурации и данни в базите. Повечето от проектите могат да се стартират поотделно.

1. Клониране на репозиторията

git clone https://github.com/sofia-municipality/DigitalSofia
cd DigitalSofia

2. Конфигуриране на околната среда

Всеки компонент има свой sample.env файл. Преименувайте го на .env и конфигурирайте според вашата среда.

3. Стартиране с Docker

# За стартиране на цялата платформа
docker-compose up -d

# За стартиране на отделни компоненти
cd forms-flow-api && docker-compose up -d
cd forms-flow-web && docker-compose up -d
cd forms-flow-bpm && docker-compose up -d
cd forms-flow-analytics && docker-compose up -d

4. Достъп до компонентите

• Уеб приложение: http://localhost:3000
• API: http://localhost:5000
• BPM Admin: http://localhost:8000
• Аналитика: http://localhost:7000
• Keycloak: http://localhost:8080

📚 Документация

Всеки компонент съдържа подробна документация в съответните README.md файлове:

• API Документация
• Уеб приложение
• BPM Engine
• Аналитика
• Android приложение
• iOS приложение

🔐 Сигурност

Системата имплементира модерни сигурностни практики:

• OAuth 2.0 / OpenID Connect
• JWT токени
• Evrotrust интеграция за електронни подписи
• Криптиране на чувствителни данни
• Биометрична автентикация в мобилните приложения

🌍 Локализация

Платформата поддържа:

• Български език (по подразбиране)
• Английски език
• Динамично превключване между езици

📱 Мобилни приложения

Android

• Минимална версия: Android 7.0 (API 24)
• Нативно Kotlin приложение
• Clean Architecture
• Biometric автентикация
• Offline capabilities

iOS

• Минимална версия: iOS 14.0
• SwiftUI интерфейс
• Touch ID / Face ID
• Push нотификации

🤝 Помощ в разработката

За да допринесете към проекта:

1. Създайте branch за вашата функционалност
2. Следвайте кодовите стандарти на проекта
3. Добавете тестове за новата функционалност
4. Създайте merge request

📞 Поддръжка

За въпроси и поддръжка:

• Създайте issue в GitHub
• Свържете се с техническия екип

📄 Лиценз

Този проект е собственост на Столична община София.

---

© 2023-2025 Столична община София. Всички права запазени.