How sriram750/data-management works
DataMatrix is a self-hosted dynamic data management platform. Its main user journey is setup or sign-in, then creating and configuring a table, managing records in a grid, and using import, export, document, and analytics capabilities. The React application calls a FastAPI API backed by PostgreSQL; backend services implement domain operations, authorization, encryption, versioning, and audit. The graph preserves README-described capabilities whose individual implementation paths were not sampled; those links are omitted or marked unverified rather than inferred from names alone.
Main entry points: App.tsx App routing · client.ts API client · audit_service.py Audit service · record_service.py Record service
Components 26
Web application
- App routing
frontend/src/App.tsx - Auth state
frontend/src/context/AuthContext.tsx - API client
frontend/src/api/client.ts - Setup and login
frontend/src/features/auth/SetupWizardPage.tsx - Table management
frontend/src/features/tables/TableListPage.tsx - Record grid
frontend/src/features/records/DynamicGridPage.tsx - Excel import
frontend/src/features/imports/ExcelImportWizard.tsx - Document studio
frontend/src/features/documents/DocumentsPage.tsx - Dashboard
frontend/src/features/dashboard/DashboardPage.tsx - Security and audit UI
frontend/src/features/security/UsersPage.tsx
API and identity
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/api/v1/auth.py - Authentication service
backend/app/services/auth_service.py - LDAP provider
backend/app/ldap/auth_provider.py
Dynamic data
- Table and column services
backend/app/services/table_service.py - Record service
backend/app/services/record_service.py - Dynamic data models
backend/app/models/dynamic_table.py - Database session layer
backend/app/core/database.py
Data operations
- Import service
backend/app/services/import_service.py - Export service
backend/app/services/export_service.py - Attachment service
backend/app/services/attachment_service.py
Security and oversight
- Audit service
backend/app/services/audit_service.py - RBAC service
backend/app/services/rbac_service.py - Field encryption
backend/app/core/encryption.py
Other components
- Organization user
- PostgreSQL
Connections 33
- Organization user → App routing: uses
frontend/src/App.tsx - App routing → Auth state: provides auth
frontend/src/App.tsx - App routing → Setup and login: routes to
frontend/src/App.tsx - App routing → Table management: routes to
frontend/src/App.tsx - App routing → Record grid: routes to
frontend/src/App.tsx - App routing → Excel import: routes to
frontend/src/App.tsx - App routing → Document studio: routes to
frontend/src/App.tsx - App routing → Dashboard: routes to
frontend/src/App.tsx - App routing → Security and audit UI: routes to
frontend/src/App.tsx - Auth state → API client: requests status
frontend/src/context/AuthContext.tsx - Setup and login → API client: submits credentials
- Table management → API client: requests tables
frontend/src/features/tables/TableListPage.tsx - Record grid → API client: requests records
frontend/src/features/records/DynamicGridPage.tsx - Excel import → API client: uploads data
- Document studio → API client: requests documents
frontend/src/features/documents/DocumentsPage.tsx - API client → FastAPI application: calls REST API
README.md - FastAPI application → Authentication routes: registers routes
backend/app/main.py - Authentication routes → Authentication service: delegates auth
backend/app/api/v1/auth.py - Authentication service → RBAC service: loads permissions
backend/app/services/auth_service.py - Authentication service → Audit service: records events
backend/app/services/auth_service.py - Authentication service → LDAP provider: may authenticate
- Table and column services → Dynamic data models: uses models
backend/app/services/table_service.py - Record service → Dynamic data models: uses models
backend/app/services/record_service.py - Record service → RBAC service: checks access
backend/app/services/record_service.py - Record service → Audit service: records changes
backend/app/services/record_service.py - Record service → Field encryption: encrypts fields
backend/app/services/record_service.py - Import service → Table and column services: uses table logic
backend/app/services/import_service.py - Import service → RBAC service: checks access
backend/app/services/import_service.py - Import service → Audit service: records imports
backend/app/services/import_service.py - Export service → Audit service: audits exports
- Attachment service → Audit service: records events
backend/app/services/attachment_service.py - Dynamic data models → Database session layer: uses base
backend/app/models/dynamic_table.py - Database session layer → PostgreSQL: connects to