Please review the codebase and create or update the following documentation files while maintaining their existing structure and format.

Required Documentation:
1. README.md
2. ARCHITECTURE.md

Documentation Standards:
- Maintain existing document structure (if applicable)
- Be concise yet informative
- Use professional British English
- Use proper Markdown formatting
- Create or update Mermaid diagrams if applicable

Focus Areas:
1. Technical accuracy
2. Clarity and readability
3. Completeness of information
4. Consistency across documents
5. Current best practices
6. Data model documentation

Key constraints:
- This is an incremental update to existing documentation
- Only update or add documention as necessary 
- Keep a consitent tone and style with existing content
- Use British English

Provide a complete, production-ready update in British English with a professional tone.