Project Overview

What is Striae?

Striae is a cloud-native forensic annotation application built specifically for forensic firearms examination. It harnesses global cloud infrastructure (leveraging Cloudflare) to deliver unmatched capabilities in accessibility, security, and operational efficiency for firearms examiners worldwide.

Project Structure

striae/
├── .github/                     # GitHub configuration and workflows
├── app/                          # Main Remix application
│   ├── assets/                  # Application assets (icons, images)
│   ├── components/              # React components
│   ├── config/                  # Configuration files
│   ├── config-example/          # Example configuration templates
│   ├── contexts/               # React contexts (auth)
│   ├── hooks/                  # Custom React hooks
│   ├── routes/                  # Application routes/pages
│   ├── services/               # Firebase and external services
│   ├── styles/                 # Global styles and CSS utilities
│   ├── types/                  # TypeScript type definitions
│   └── utils/                  # Utility functions
├── build/                       # Production build output
├── functions/                  # Cloudflare Pages Functions
├── guides/                     # Documentation (this directory)
├── public/                     # Static assets
├── release-notes/              # Version release documentation
├── scripts/                    # Build and deployment scripts
└── workers/                     # Cloudflare Workers
    ├── data-worker/            # Case data management
    ├── image-worker/           # Image upload/management
    ├── keys-worker/            # API key management
    ├── pdf-worker/             # PDF generation
    ├── turnstile-worker/       # CAPTCHA verification
    └── user-worker/            # User data management

Tech Stack

Frontend

  • Framework: Remix (React-based full-stack framework)

  • Styling: CSS Modules + Tailwind CSS

  • Type Safety: TypeScript

  • Authentication: Firebase Auth with MFA support

  • State Management: React hooks and context

Backend/Infrastructure

  • Platform: Cloudflare Pages + Workers

  • Database: Cloudflare KV (Key-Value storage)

  • Data Storage: Cloudflare R2 (Object storage)

  • File Storage: Cloudflare Images

  • Authentication: Firebase Authentication

  • Build Tool: Vite

  • Deployment: Wrangler (Cloudflare CLI)

Key Features

  • Canvas-based annotation system for comparison image annotation with box annotations

  • Case management with file organization

  • Comprehensive data export with JSON, CSV, Excel, and ZIP formats including image packaging

  • Case review import system for collaborative case review with ZIP package import and read-only protection

  • PDF report generation with annotations

  • Multi-factor authentication for security

  • Real-time image annotation with various marking features including box tool

  • Cloud-native architecture for global accessibility and scalability

  • ZIP export functionality for complete case packaging with images and data files

  • Read-only case protection for secure peer review and collaboration workflows

  • Comprehensive audit trail system for forensic accountability and compliance tracking

Development Philosophy

Striae is built with several key principles:

  1. Security First: Every component implements security best practices

  2. User Experience: Intuitive interface designed for forensic firearms examiners

  3. Performance: Optimized for handling high-resolution comparison images

  4. Scalability: Cloud-native architecture that scales globally

  5. Compliance: Built with forensic evidence handling requirements in mind

Key Differentiators

  • Specialized for Firearms Examination: Unlike general forensic tools, Striae is purpose-built for firearms examination

  • Cloud-Native: No local infrastructure required

  • Global Accessibility: Available anywhere with internet connection

  • Advanced Security: Multi-layer security including MFA, encryption, and access controls

  • Modern Architecture: Built on latest web technologies for performance and maintainability

Getting Started

For new developers joining the project:

  1. Read this overview to understand the project scope

  2. Follow the Installation Guide to set up your development environment

  3. Review the Architecture Guide to understand the system design

  4. Study the Error Handling Guide for proper error management patterns

  5. Check the API Documentation for backend integrations

  6. Explore the Component Guide for frontend development

Project Status

Striae is currently v1.0.3. The project is actively maintained and welcomes contributions from the forensic technology community.

Support

For support and questions:

License

This project is licensed under Apache 2.0. Please refer to the LICENSE and NOTICE files for more information.

Credits

This project was entirely designed and developed by Stephen J. Lu

Updated on
Welcome
Striae Architecture