AI-powered mobile document scanner that captures physical documents and converts them to structured digital formats.
- 📷 Smart Document Capture - Camera-based scanning with auto-crop and perspective correction
- 🔍 OCR Engine - Extract text from printed and handwritten documents
- 📊 Table Detection - Automatically detect and extract tables
- 📁 Multiple Export Formats - Export to PDF, Excel, CSV, JSON, Markdown
- 🔄 Offline Support - Queue uploads when offline, sync when connected
- 🔒 Secure - End-to-end encryption, data isolation, GDPR compliance
┌─────────────────────────────────────────────────────────────────┐
│ Mobile App (Expo) │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────────────────┐ │
│ │ Camera │ │ Image │ │ Upload │ │ Offline Queue │ │
│ │ Capture │→ │ Process │→ │ Manager │→ │ (Background Sync) │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Backend API (Express) │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────────────────┐ │
│ │ Auth │ │ Upload │ │ Jobs │ │ Rate Limiting │ │
│ │ JWT │ │ Handler │ │ Queue │ │ Validation │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
┌────────────────────┼────────────────────┐
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────────┐
│ Postgres │ │ Redis │ │ MinIO │
│ DB │ │ Queue │ │ Storage │
└──────────┘ └──────────┘ └──────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ AI Workers (Python/FastAPI) │
│ ┌────────────┐ ┌─────┐ ┌────────┐ ┌────────┐ ┌───────────┐│
│ │ Preprocess │→ │ OCR │→ │ Layout │→ │ Tables │→ │ Structure ││
│ │ Image │ │ │ │ Detect │ │ Extract│ │ Data ││
│ └────────────┘ └─────┘ └────────┘ └────────┘ └───────────┘│
└─────────────────────────────────────────────────────────────────┘
- Expo SDK 54 - Managed workflow
- React Native - Cross-platform UI
- TypeScript - Type safety
- React Navigation - Native stack navigation
- Express.js - HTTP server
- Prisma - PostgreSQL ORM
- BullMQ - Job queue
- Jose - JWT authentication
- Zod - Request validation
- FastAPI - Python API server
- OpenCV - Image processing
- Tesseract/EasyOCR - Text recognition
- LayoutParser - Document layout detection
- img2table - Table extraction
- PostgreSQL - Primary database
- Redis - Job queue & caching
- MinIO - S3-compatible object storage
- Docker - Containerization
- Node.js 20+
- Python 3.11+
- Docker & Docker Compose
- PostgreSQL 15+
- Redis 7+
# Clone the repository
git clone https://github.com/yourusername/structa-ai.git
cd structa-ai
# Start all services
docker-compose up -d
# The services will be available at:
# - Mobile Metro: http://localhost:8081
# - Backend API: http://localhost:3000
# - AI Workers: http://localhost:8000
# - MinIO Console: http://localhost:9001# Install dependencies
npm install
# Start Expo development server
npx expo startcd backend
# Install dependencies
npm install
# Setup environment
cp .env.example .env
# Generate Prisma client
npm run db:generate
# Run migrations
npm run db:migrate
# Start development server
npm run devcd ai-workers
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Setup environment
cp .env.example .env
# Start server
python main.pystructa-ai/
├── app/ # Mobile app screens
│ ├── screens/ # Screen components
│ └── components/ # Reusable UI components
├── domain/ # Business logic
│ ├── models/ # Data models
│ ├── workflows/ # State machines
│ └── services/ # Domain services
├── infra/ # Infrastructure layer
│ ├── camera/ # Camera service
│ ├── image/ # Image processing
│ ├── upload/ # Upload management
│ ├── api/ # API client
│ └── network/ # Network state
├── backend/ # Node.js backend
│ ├── src/
│ │ ├── api/ # Express routes
│ │ ├── config/ # Configuration
│ │ └── services/ # Business services
│ └── prisma/ # Database schema
├── ai-workers/ # Python AI processing
│ ├── processors/ # AI processors
│ └── exporters/ # Export services
└── docker-compose.yml # Docker orchestration
POST /api/auth/register- Create accountPOST /api/auth/login- LoginPOST /api/auth/logout- LogoutGET /api/auth/profile- Get profile
GET /api/documents- List documentsPOST /api/documents- Create documentGET /api/documents/:id- Get documentDELETE /api/documents/:id- Delete documentGET /api/documents/:id/status- Processing statusPOST /api/documents/:id/process- Start processing
POST /api/uploads/:documentId/pages- Upload pageDELETE /api/uploads/:documentId/pages/:pageId- Delete pagePUT /api/uploads/:documentId/pages/reorder- Reorder pages
DATABASE_URL=postgresql://user:pass@localhost:5432/structa
REDIS_URL=redis://localhost:6379
JWT_SECRET=your-secret-key
STORAGE_ENDPOINT=http://localhost:9000
STORAGE_BUCKET=structa-documentsAI_PORT=8000
AI_REDIS_URL=redis://localhost:6379
AI_OCR_ENGINE=tesseract
AI_STORAGE_TYPE=s3- ✅ Phase 1: Foundation (Expo, TypeScript, Models)
- ✅ Phase 2: Mobile Runtime (Permissions, Storage, Background)
- ✅ Phase 3: Image Quality (Preprocessing, Multi-page)
- ✅ Phase 4: Network & Transfer (Chunked Upload, Offline Queue)
- ✅ Phase 5: Backend API (Express, Prisma, BullMQ)
- ✅ Phase 6: AI Pipeline (OCR, Layout, Tables)
- ✅ Phase 7: Data Structuring (Block Segmentation, Validation)
- ✅ Phase 8: Export (PDF, Excel, CSV, JSON)
- ✅ Phase 9: Security (Encryption, Data Isolation, Audit)
- ✅ Phase 10: Scalability (Metrics, Health, Feature Flags)
MIT License - see LICENSE for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
