800bc1069d
docs: Update architecture overview to reflect v0.9.5 implementation
...
Comprehensively updated docs/architecture/overview.md to document the
actual v0.9.5 implementation instead of aspirational V1 features.
Major Changes:
1. Executive Summary
- Added version tag (v0.9.5) and status (Pre-V1 Release)
- Updated tech stack: Python 3.11, uv, Gunicorn, Gitea Actions
- Added deployment context (container-based, CI/CD)
2. Route Documentation
- Public routes: Documented actual routes (/, /note/<slug>, /feed.xml, /health)
- Admin routes: Updated from /admin/* to /auth/* (v0.9.2 change)
- Added development routes (/dev/login)
- Clearly marked implemented vs. planned routes
3. API Layer Reality Check
- Notes API: Marked as NOT IMPLEMENTED (optional, deferred to V2)
- Micropub endpoint: Marked as NOT IMPLEMENTED (critical V1 blocker)
- RSS feed: Marked as IMPLEMENTED with full feature list (v0.6.0)
4. Authentication Flow Updates
- Documented PKCE implementation (v0.8.0)
- Updated IndieLogin flow to use /authorize endpoint (v0.9.4)
- Added trailing slash normalization (v0.9.1)
- Documented session token hashing (SHA-256)
- Updated cookie name (starpunk_session, v0.5.1)
- Corrected code verification endpoint usage
5. Database Schema
- Added schema_migrations table (v0.9.0)
- Added code_verifier to auth_state (v0.8.0)
- Documented automatic migration system
- Added session metadata fields (user_agent, ip_address)
- Updated indexes for performance
6. Container Deployment (NEW)
- Multi-stage Containerfile documentation
- Gunicorn WSGI server configuration
- Health check endpoint
- CI/CD pipeline (Gitea Actions)
- Volume persistence strategy
7. Implementation Status Section (NEW)
- Comprehensive list of implemented features (v0.3.0-v0.9.5)
- Clear documentation of unimplemented features
- Micropub marked as critical V1 blocker
- Standards validation status (partial)
8. Success Metrics
- Updated with actual achievements
- 70% complete toward V1
- Container deployment working
- Automated migrations implemented
Security documentation now accurately reflects PKCE implementation,
session token hashing, and correct IndieLogin.com API usage.
All route tables, data flow diagrams, and examples updated to match
v0.9.5 codebase reality.
Related: Architect validation report identified need to update
architecture docs to reflect actual implementation vs. planned features.
2025-11-24 11:03:44 -07:00
066cde8c46
docs: Extract and organize CLAUDE.MD content, restructure documentation
...
This commit performs comprehensive documentation reorganization:
1. Extracted testing checklist from CLAUDE.MD to docs/standards/testing-checklist.md
- Consolidated manual testing checklist
- Added validation tools and resources
- Created pre-release validation workflow
2. Streamlined CLAUDE.md to lightweight operational instructions
- Python environment setup (uv)
- Agent-developer protocol
- Key documentation references
- Removed redundant content (already in other docs)
3. Removed CLAUDE.MD (uppercase) - content was redundant
- All content already exists in architecture/overview.md and projectplan docs
- Only unique content (testing checklist) was extracted
4. Moved root documentation files to appropriate locations:
- CONTAINER_IMPLEMENTATION_SUMMARY.md -> docs/reports/2025-11-19-container-implementation-summary.md
- QUICKFIX-AUTH-LOOP.md -> docs/reports/2025-11-18-quickfix-auth-loop.md
- TECHNOLOGY-STACK-SUMMARY.md -> docs/architecture/technology-stack-legacy.md
- TODO_TEST_UPDATES.md -> docs/reports/2025-11-19-todo-test-updates.md
5. Consolidated design folders:
- Moved all docs/designs/ content into docs/design/
- Renamed PHASE-5-EXECUTIVE-SUMMARY.md to phase-5-executive-summary.md (consistent naming)
- Removed empty docs/designs/ directory
6. Added ADR-021: IndieAuth Provider Strategy
- Documents decision to build own IndieAuth provider
- Explains rationale and trade-offs
Repository root now contains only: README.md, CLAUDE.md, CHANGELOG.md
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-11-24 10:17:50 -07:00
68669b9a6a
docs: add reference IndieAuth identity page implementation
...
Add minimal, production-ready static HTML identity page as reference
implementation for IndieAuth authentication.
Includes:
- Complete identity-page.html with h-card and IndieAuth endpoints
- Architectural documentation and rationale
- ADR-010: Static Identity Page decision record
- Customization guide for users
The example is zero-dependency, copy-paste ready, and guaranteed to
work with IndieLogin.com and StarPunk. Pre-configured for
thesatelliteoflove.com as working example.
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-11-19 13:03:49 -07:00
