Documentation: utils / postsMenuService
Purpose:
Build chronological menu of blog posts.
Lifecycle Role:
Used when rendering blog navigation UI.
Dependencies:
Upstream:
- getAllPosts
- qualifyLink
Downstream:
- view templates
- controllers
Data Flow:
Inputs:
baseDir of posts
Outputs:
grouped year/month menu array
Side Effects:
None
Performance and Scalability:
Bottlenecks:
- disk I/O reading posts
Concurrency:
None
Security and Stability:
Validation:
None
Vulnerabilities:
- unsanitized metadata rendering
Architecture Assessment:
Coupling:
Moderate to post data util
Abstraction:
Pure data formatter
Recommendations:
- Add caching
- Validate metadata
- Optimize grouping logic