Project Overview
Modern Implementation
Clean-room implementation in TypeScript/React Native with modern architectural patterns.
Educational Focus
Comprehensive educational layer to enhance understanding of the Traditional Latin Mass.
Clear Separation
Maintains strict boundaries between reference implementation and modern rewrite.
Architectural Philosophy
This architecture ensures clear separation between the reference implementation and our modern rewrite, maintaining proper licensing boundaries while enabling efficient development of a TypeScript/React Native application with comprehensive educational features.
Repository Structure
Project Organization
├── reference/ # Original Divinum Officium (Perl)
├── typescript-app/ # Modern TypeScript Implementation
└── docs/ # Project Documentation
- Original Divinum Officium Perl codebase
- Used solely as functional reference
- Maintains clear licensing boundaries
- Clean-room implementation
- TypeScript/React Native stack
- Modern development practices
- Centralized documentation
- Architectural guidelines
- Development standards
Design Decisions
Parent Repository Pattern
Main repository serves as an organizational wrapper maintaining clear separation between reference and implementation while providing centralized documentation.
Submodule Structure
Clear separation between reference implementation and modern TypeScript application with independent, non-derivative codebase.
Clean Room Implementation
Complete separation from original codebase with independent development approach using modern architectural patterns.
Documentation Strategy
Centralized documentation with clear architectural guidelines, development standards, and comprehensive API documentation.
Critical Design Principle
Maintain strict separation between reference and implementation to preserve licensing boundaries while enabling modern development practices.
Educational Layer Architecture
Content Types
- Quick Definitions
- Detailed Explanations
- Historical Context
- Spiritual Significance
- Latin Insights
- Pronunciations
Access Methods
- Tap/Click
- Hover States
- Quick Search
- Reference Index
Display Methods
- Interactive Tooltips
- Side Panels
- Bottom Sheets
- Reference Drawer
Knowledge Levels
- Basic Introduction
- Intermediate
- Advanced Theology
- Language Details
Content-Display Relationships
- Quick Tooltip
- Detail Panel
- History Drawer
- Spirit Sheet
Access-Content Relationships
- Tap Quick
- Hover Detail
- Search Index
- Index All Content
Educational Features Checklist
Content Accessibility
Interactive Terms
Enable quick understanding of Latin terms
Saint Information
Provide context for feast days
Liturgical Explanations
Clarify ritual significance
Latin Insights
Bridge language understanding
User Interface Elements
Tooltip System
Quick access to definitions
Side Panel
Detailed explanations
Bottom Sheet
Mobile-friendly deep dives
Reference Drawer
Comprehensive resource access
