feat(tags): Add database schema and tags module (v1.3.0 Phase 1)
Implements tag/category system backend following microformats2 p-category specification. Database changes: - Migration 008: Add tags and note_tags tables - Normalized tag storage (case-insensitive lookup, display name preserved) - Indexes for performance New module: - starpunk/tags.py: Tag management functions - normalize_tag: Normalize tag strings - get_or_create_tag: Get or create tag records - add_tags_to_note: Associate tags with notes (replaces existing) - get_note_tags: Retrieve note tags (alphabetically ordered) - get_tag_by_name: Lookup tag by normalized name - get_notes_by_tag: Get all notes with specific tag - parse_tag_input: Parse comma-separated tag input Model updates: - Note.tags property (lazy-loaded, prefer pre-loading in routes) - Note.to_dict() add include_tags parameter CRUD updates: - create_note() accepts tags parameter - update_note() accepts tags parameter (None = no change, [] = remove all) Micropub integration: - Pass tags to create_note() (tags already extracted by extract_tags()) - Return tags in q=source response Per design doc: docs/design/v1.3.0/microformats-tags-design.md Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
160
docs/design/v1.1.1/hotfix-validation-script.md
Normal file
160
docs/design/v1.1.1/hotfix-validation-script.md
Normal file
@@ -0,0 +1,160 @@
|
||||
# Hotfix Validation Script for v1.1.1-rc.2
|
||||
|
||||
## Quick Validation Commands
|
||||
|
||||
Run these commands after applying the hotfix to verify it works:
|
||||
|
||||
### 1. Check Route Registration
|
||||
```python
|
||||
# In Flask shell (uv run flask shell)
|
||||
from starpunk import create_app
|
||||
app = create_app()
|
||||
|
||||
# List all admin routes
|
||||
for rule in app.url_map.iter_rules():
|
||||
if 'admin' in rule.endpoint:
|
||||
print(f"{rule.endpoint:30} -> {rule.rule}")
|
||||
|
||||
# Expected output:
|
||||
# admin.dashboard -> /admin/
|
||||
# admin.metrics_dashboard -> /admin/metrics-dashboard
|
||||
# admin.metrics -> /admin/metrics
|
||||
# admin.health_diagnostics -> /admin/health
|
||||
# (plus CRUD routes)
|
||||
```
|
||||
|
||||
### 2. Test URL Resolution
|
||||
```python
|
||||
# In Flask shell
|
||||
from flask import url_for
|
||||
with app.test_request_context():
|
||||
print("Notes dashboard:", url_for('admin.dashboard'))
|
||||
print("Metrics dashboard:", url_for('admin.metrics_dashboard'))
|
||||
|
||||
# Expected output:
|
||||
# Notes dashboard: /admin/
|
||||
# Metrics dashboard: /admin/metrics-dashboard
|
||||
```
|
||||
|
||||
### 3. Simulate Production Environment (No Monitoring Module)
|
||||
```bash
|
||||
# Temporarily rename monitoring module if it exists
|
||||
mv starpunk/monitoring.py starpunk/monitoring.py.bak 2>/dev/null
|
||||
|
||||
# Start the server
|
||||
uv run flask run
|
||||
|
||||
# Test the routes
|
||||
curl -I http://localhost:5000/admin/ # Should return 302 (redirect to auth)
|
||||
curl -I http://localhost:5000/admin/metrics-dashboard # Should return 302 (not 500!)
|
||||
|
||||
# Restore monitoring module if it existed
|
||||
mv starpunk/monitoring.py.bak starpunk/monitoring.py 2>/dev/null
|
||||
```
|
||||
|
||||
### 4. Manual Browser Testing
|
||||
|
||||
After logging in with IndieAuth:
|
||||
|
||||
1. Navigate to `/admin/` - Should show notes list
|
||||
2. Click "Metrics" in navigation - Should load `/admin/metrics-dashboard`
|
||||
3. Click "Dashboard" in navigation - Should return to `/admin/`
|
||||
4. Create a new note - Should redirect to `/admin/` after creation
|
||||
5. Edit a note - Should redirect to `/admin/` after saving
|
||||
6. Delete a note - Should redirect to `/admin/` after deletion
|
||||
|
||||
### 5. Check Error Logs
|
||||
```bash
|
||||
# Monitor Flask logs for any errors
|
||||
uv run flask run 2>&1 | grep -E "(ERROR|CRITICAL|ImportError|500)"
|
||||
|
||||
# Should see NO output related to route conflicts or import errors
|
||||
```
|
||||
|
||||
### 6. Automated Test Suite
|
||||
```bash
|
||||
# Run the admin route tests
|
||||
uv run python -m pytest tests/test_admin_routes.py -v
|
||||
|
||||
# All tests should pass
|
||||
```
|
||||
|
||||
## Production Verification
|
||||
|
||||
After deploying to production:
|
||||
|
||||
### 1. Health Check
|
||||
```bash
|
||||
curl https://starpunk.thesatelliteoflove.com/health
|
||||
# Should return 200 OK
|
||||
```
|
||||
|
||||
### 2. Admin Routes (requires auth)
|
||||
```bash
|
||||
# These should not return 500
|
||||
curl -I https://starpunk.thesatelliteoflove.com/admin/
|
||||
curl -I https://starpunk.thesatelliteoflove.com/admin/metrics-dashboard
|
||||
```
|
||||
|
||||
### 3. Monitor Error Logs
|
||||
```bash
|
||||
# Check production logs for any 500 errors
|
||||
tail -f /var/log/starpunk/error.log | grep "500"
|
||||
# Should see no new 500 errors
|
||||
```
|
||||
|
||||
### 4. User Verification
|
||||
1. Log in to admin panel
|
||||
2. Verify both dashboards accessible
|
||||
3. Perform one CRUD operation to verify redirects
|
||||
|
||||
## Rollback Commands
|
||||
|
||||
If issues are discovered:
|
||||
|
||||
```bash
|
||||
# Quick rollback to previous version
|
||||
git checkout v1.1.1-rc.1
|
||||
systemctl restart starpunk
|
||||
|
||||
# Or if using containers
|
||||
docker pull starpunk:v1.1.1-rc.1
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
## Success Indicators
|
||||
|
||||
✅ No 500 errors in logs
|
||||
✅ Both dashboards accessible
|
||||
✅ All redirects work correctly
|
||||
✅ Navigation links functional
|
||||
✅ No ImportError in logs
|
||||
✅ Existing functionality unchanged
|
||||
|
||||
## Report Template
|
||||
|
||||
After validation, report:
|
||||
|
||||
```
|
||||
HOTFIX VALIDATION REPORT - v1.1.1-rc.2
|
||||
|
||||
Date: [DATE]
|
||||
Environment: [Production/Staging]
|
||||
|
||||
Route Resolution:
|
||||
- /admin/ : ✅ Shows notes dashboard
|
||||
- /admin/metrics-dashboard : ✅ Loads without error
|
||||
|
||||
Functionality Tests:
|
||||
- Create Note: ✅ Redirects to /admin/
|
||||
- Edit Note: ✅ Redirects to /admin/
|
||||
- Delete Note: ✅ Redirects to /admin/
|
||||
- Navigation: ✅ All links work
|
||||
|
||||
Error Monitoring:
|
||||
- 500 Errors: None observed
|
||||
- Import Errors: None observed
|
||||
- Flash Messages: Working correctly
|
||||
|
||||
Conclusion: Hotfix successful, ready for production
|
||||
```
|
||||
Reference in New Issue
Block a user