Files
DMS/README.md
2025-05-15 14:18:01 +02:00

96 lines
3.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🧾 Podsumowanie aplikacji do zarządzania obiegiem dokumentów
## 🏢 Cel aplikacji
System klasy BDO / BPM do zarządzania elektronicznym obiegiem dokumentów w firmie, z obsługą wielu typów dokumentów, działów, niestandardowych workflow, OCR oraz pełną integracją z LDAP i systemami zewnętrznymi.
## 🧩 Główne funkcje
### 1. LDAP Logowanie i dane użytkownika
Logowanie użytkownika przez LDAP (np. AD).
Pobieranie danych:
- Imię i nazwisko
- Login
- Email
- Dział i stanowisko
- Kierownik (DN)
- Lokalizacja biura
### 2. Zarządzanie dokumentami
- Obsługa różnych typów dokumentów: faktury, umowy, pisma, wnioski.
- Dynamiczne formularze z custom fields (tworzone przez administratora).
- Dodawanie załączników (PDF, DOCX, JPG itd.).
- Dodawanie notatek wewnętrznych.
- Historia zmian: co, kiedy, przez kogo.
### 3. Workflow (obieg dokumentu)
- Konfigurowalne etapy workflow: np. Spedytor → Kierownik → Administracja → Księgowość → Archiwum.
- Możliwość zdefiniowania różnych obiegów dla różnych działów lub typów dokumentów.
- Obsługa przekazywania dokumentu dalej, zatwierdzeń, komentarzy.
### 4. Graficzny kreator workflow
- Interfejs typu drag & drop do tworzenia i edycji ścieżek workflow.
- Tworzenie etapów i przypisywanie ich do grup LDAP lub ról wewnętrznych.
- Walidacja połączeń między etapami.
### 5. Powiadomienia e-mail
- Wysyłka e-maili przy zmianie etapu (np. "Dokument ID#203 oczekuje na Twoją akceptację").
- Możliwość konfiguracji szablonów wiadomości.
- Obsługa SMTP z uwierzytelnieniem.
### 6. OCR i przetwarzanie danych
- Automatyczny OCR (np. Tesseract, Google Vision API) dla zeskanowanych dokumentów.
- Wydobywanie danych z faktur, umów (np. NIP, kwoty, daty).
- Przechowywanie danych OCR w bazie, możliwość ich edycji.
- OCR inicjowany automatycznie po przesłaniu dokumentu.
### 7. Pobieranie dokumentów
- Podgląd dokumentu w przeglądarce (PDF.js, embed).
- Możliwość pobrania dokumentu oryginalnego i wersji z OCR.
- Logowanie kto i kiedy pobrał dokument (dla audytu).
### 8. REST API
Bezpieczne API z tokenami (Authorization: Bearer ...)
Endpointy:
- `GET /documents` lista dokumentów
- `POST /documents` dodanie dokumentu
- `GET /document/{id}` szczegóły
- `GET /document/{id}/history` historia zmian
- `GET /workflow` definicje obiegów
API dla integracji z systemem ERP, archiwum zewnętrznym, SAP itp.
## 🗃️ Struktura danych
Tabele główne:
- `users` dane użytkowników z LDAP
- `documents` metadane dokumentów
- `document_files` załączniki
- `document_fields` custom fields
- `workflows` definicje obiegów
- `workflow_steps` etapy
- `document_history` logi zmian
- `notes` notatki
- `ocr_data` dane z OCR
## 💻 Technologie
- PHP 8.1+, PDO, Composer
- Bootstrap 5.3.3, JavaScript (opcjonalnie Vue.js)
- LDAP (autoryzacja, dane użytkownika)
- Tesseract OCR lub zewnętrzne API (np. Google Vision)
- PDF.js do podglądu dokumentów
- MySQL / PostgreSQL jako baza danych
- PHPMailer do powiadomień
## 🔐 Bezpieczeństwo
- Autoryzacja oparta na LDAP i/lub JWT
- Uprawnienia per etap i typ dokumentu
- Logi audytowe każdej akcji
- Filtracja i walidacja danych użytkownika
## 🧠 Możliwości rozwoju
- Podpisy elektroniczne
- Aplikacja mobilna (PWA lub natywna)
- Dashboard BI z analizą ilości dokumentów, czasu przetwarzania itd.