(C)2025 Robin L. M. Cheung, MBA
This document outlines the architectural decisions and structure of the Sanctissi Missa project.
The project is organized as a parent repository with two key submodules:
sanctissi-missa/
├── reference/ # Original Divinum Officium (Perl)
├── typescript-app/ # Modern TypeScript Implementation
└── docs/ # Project Documentation
I think it's
- Main repository serves as an organizational wrapper
- Maintains clear separation between reference and implementation
- Provides centralized documentation and project management
-
Reference Implementation (
/reference)- Original Divinum Officium Perl codebase
- Used solely as functional reference
- Maintains clear licensing boundaries
-
TypeScript Implementation (
/typescript-app)- Clean-room implementation in TypeScript/React Native
- Modern architecture and development practices
- Independent, non-derivative codebase
- Complete separation from original codebase
- Independent development approach
- Modern architectural patterns
- TypeScript/React Native stack
- Centralized documentation in
/docs - Clear architectural guidelines
- Development standards and practices
- API documentation
- TypeScript
- React Native
- Modern development tools and practices
- Maintain strict separation between reference and implementation
- Document all major architectural decisions
- Follow modern development practices
- Maintain comprehensive test coverage
Copyright (C)2025 Robin L. M. Cheung, MBA
All rights reserved.
This architecture ensures clear separation between the reference implementation and our modern rewrite, maintaining proper licensing boundaries while enabling efficient development.
graph TB
subgraph "Content Types"
Quick[Quick Definitions]
Detail[Detailed Explanations]
History[Historical Context]
Spirit[Spiritual Significance]
Latin[Latin Insights]
Audio[Pronunciations]
end
subgraph "Access Methods"
Tap[Tap/Click]
Hover[Hover States]
Search[Quick Search]
Index[Reference Index]
end
subgraph "Display Methods"
Tooltip[Interactive Tooltips]
Panel[Side Panels]
Sheet[Bottom Sheets]
Drawer[Reference Drawer]
end
subgraph "Knowledge Levels"
Basic[Basic Introduction]
Inter[Intermediate]
Adv[Advanced Theology]
Lang[Language Details]
end
Quick --> Tooltip
Detail --> Panel
History --> Drawer
Spirit --> Sheet
Latin --> Panel
Audio --> Tooltip
Tap --> Quick
Hover --> Detail
Search --> Index
Index --> All[A
8000
ll Content]
erDiagram
TERM {
string id
string term
string quick_def
string detailed_exp
string context
array categories
string pronunciation
}
SAINT {
string id
string name
string biography
string significance
array feast_days
}
LITURGICAL_ELEMENT {
string id
string name
string explanation
string history
string spiritual_significance
}
LATIN_INSIGHT {
string id
string text
string grammar_notes
string cultural_context
string spiritual_meaning
}
TERM ||--o{ CATEGORY : belongs_to
TERM ||--o{ RELATED_TERMS : connects
SAINT ||--o{ LITURGICAL_ELEMENT : associated_with
LITURGICAL_ELEMENT ||--o{ LATIN_INSIGHT : contains
graph LR
subgraph "Interactive Elements"
Term[Terms]
Saint[Saints]
Prayer[Prayers]
Ritual[Rituals]
end
subgraph "Visual Cues"
Underline[Subtle Underline]
Icon[Icon Indicator]
Color[Color Coding]
Gesture[Gesture Hint]
end
Term --> Underline
Saint --> Icon
Prayer --> Color
Ritual --> Gesture
| Feature | Status | Rationale | Priority |
|---|---|---|---|
| Interactive Terms | 🔲 | Enable quick understanding of Latin terms | High |
| Saint Information | 🔲 | Provide context for feast days | High |
| Liturgical Explanations | 🔲 | Clarify ritual significance | High |
| Latin Insights | 🔲 | Bridge language understanding | High |
| Feature | Status | Rationale | Priority |
|---|---|---|---|
| Tooltip System | 🔲 | Quick access to definitions | High |
| Side Panel | 🔲 | Detailed explanations | High |
| Bottom Sheet | 🔲 | Mobile-friendly deep dives | High |
| Reference Drawer | 🔲 | Comprehensive resource access | Medium |
| Feature | Status | Rationale | Priority |
|---|---|---|---|
| Basic Definitions | 🔲 | Entry-level understanding | High |
| Detailed Context | 🔲 | Deeper comprehension | Medium |
| Theological Insights | 🔲 | Advanced understanding | Medium |
| Pronunciation Guide | 🔲 | Proper Latin pronunciation | High |
-
Metadata System
- Term tagging
- Difficulty levels
- Related content links
- Context markers
-
Loading Strategy
- Progressive loading
- Preload common terms
- Background fetching
- Offline availability
-
Interaction Handling
- Touch/click detection
- Gesture recognition
- View state management
- History tracking
-
Level 1: Quick Access
- Brief definitions
- Basic context
- Essential pronunciation
- Quick navigation
-
Level 2: Detailed Information
- Historical background
- Theological context
- Latin grammar insights
- Related references
-
Level 3: Deep Understanding
- Scholarly resources
- Cross-references
- Theological implications
- Cultural context
-
Interactive Indicators
- Subtle underlining for terms
- Icon system for content types
- Color coding for categories
- Clear touch targets
-
Content Display
- Clean, readable layout
- Proper hierarchy
- Consistent styling
- Responsive design
| Metric | Target | Rationale |
|---|---|---|
| Tooltip Display | < 100ms | Immediate feedback |
| Content Load | < 500ms | Smooth interaction |
| Search Response | < 200ms | Quick reference |
| Offline Access | 100% | Full functionality |
This educational layer enhances the user's understanding and appreciation of the Traditional Latin Mass and Divine Office while maintaining a focus on the primary liturgical content. The implementation prioritizes intuitive discovery and seamless learning without overwhelming the user.
[Previous content continues unchanged...]