docs: Update project plan files

This commit is contained in:
2025-12-10 11:58:45 -07:00
parent 5ca8b7e9b4
commit f901aa2242
2 changed files with 75 additions and 26 deletions

View File

@@ -1,21 +1,69 @@
# StarPunk v1.3.0 Release
**Status**: Planning
**Status**: Complete
**Codename**: "Categories"
**Branch**: `feature/v1.3.0-tags-microformats`
**Approved**: 2025-12-10
## Features
### Strict Microformats2 Compliance
- Complete h-entry properties (p-name, p-summary, p-author)
- Author h-card implementation
- h-feed wrapper for index pages
- Full IndieWeb parser compatibility
- Microformats2 validation suite
- See: ADR-040
### Tag/Category System (Complete)
- Database schema for tags (`migrations/008_add_tags.sql`)
- Tag management module (`starpunk/tags.py`)
- Micropub category property support
- Admin interface for tag editing
- Tag archive pages (`/tag/<tag>`)
- p-category microformats2 markup with `rel="tag"`
### Strict Microformats2 Compliance (Complete)
- h-feed required properties: p-name, p-author (h-card), u-url, u-photo
- h-entry p-category for tags
- u-photo placement outside e-content per draft spec
- Author h-card with u-photo and p-note (graceful fallback)
- mf2py validation test suite
## Implementation Phases
1. **Phase 1: Database and Backend** - Complete
- Migration 008 for tags schema
- Tags module with normalization
- Notes CRUD updated for tags parameter
- Micropub integration
2. **Phase 2: Templates** - Complete
- h-feed enhancements on index.html
- p-category markup on note.html
- Tag archive template (tag.html)
3. **Phase 3: Routes and Admin** - Complete
- Tag archive route
- Admin form tag input
- Tags pre-loaded in routes
4. **Phase 4: Validation** - Complete
- mf2py validation tests
- Test fixtures for tags and media
## Bugs Addressed
*None planned*
*None*
## Implementation
## Known Limitations
See `docs/design/v1.3.0/` for implementation details and reports.
- No pagination on tag archive pages (future enhancement)
- No tag autocomplete in admin (future enhancement)
- No tag-filtered feeds (moved to backlog)
## Test Results
- 333 tests passed
- 1 pre-existing flaky test (unrelated to v1.3.0)
- All microformats validation tests pass
## Documentation
- Design: `docs/design/v1.3.0/microformats-tags-design.md`
- Phase 1 Report: `docs/design/v1.3.0/2025-12-10-phase1-implementation.md`
- Phase 2 Report: `docs/design/v1.3.0/2025-12-10-phase2-implementation.md`
- Phase 3 Report: `docs/design/v1.3.0/2025-12-10-phase3-implementation.md`
- Phase 4 Report: `docs/design/v1.3.0/2025-12-10-phase4-implementation.md`