docs(02): capture phase context
Phase 02: Core CRUD - Quick capture: fixed bottom, title+content, remember last type - Layout: mixed cards/compact, tasks then thoughts, hide completed - Editing: inline expand, auto-save, swipe to delete
This commit is contained in:
79
.planning/phases/02-core-crud/02-CONTEXT.md
Normal file
79
.planning/phases/02-core-crud/02-CONTEXT.md
Normal file
@@ -0,0 +1,79 @@
|
|||||||
|
# Phase 2: Core CRUD - Context
|
||||||
|
|
||||||
|
**Gathered:** 2026-01-29
|
||||||
|
**Status:** Ready for planning
|
||||||
|
|
||||||
|
<domain>
|
||||||
|
## Phase Boundary
|
||||||
|
|
||||||
|
Users can create, manage, and view entries with a responsive, accessible UI. This phase delivers:
|
||||||
|
- Entry list displaying tasks and thoughts
|
||||||
|
- Quick capture for fast entry creation
|
||||||
|
- Entry editing (title, content, type, completion status)
|
||||||
|
- Delete functionality
|
||||||
|
- Adding notes to existing entries
|
||||||
|
- Mobile-responsive UI with readable fonts
|
||||||
|
|
||||||
|
Tags, images, search, and pinning are separate phases.
|
||||||
|
|
||||||
|
</domain>
|
||||||
|
|
||||||
|
<decisions>
|
||||||
|
## Implementation Decisions
|
||||||
|
|
||||||
|
### Quick Capture
|
||||||
|
- Fixed at bottom of page (thumb-friendly on mobile)
|
||||||
|
- Two fields visible: title and content
|
||||||
|
- After submit: clear input, scroll to and briefly highlight new entry
|
||||||
|
- Default type: remember last used (sticky preference)
|
||||||
|
- Type toggle should be visible in capture UI
|
||||||
|
|
||||||
|
### Entry List Layout
|
||||||
|
- Mixed layout: cards on desktop, compact list on mobile
|
||||||
|
- Info shown per entry: title, content preview (truncated), type indicator (badge/icon)
|
||||||
|
- Do NOT show dates in list view (keep it clean)
|
||||||
|
- Default ordering: tasks first, then thoughts (within each group: newest first)
|
||||||
|
- Completed tasks: hidden by default with toggle to show
|
||||||
|
|
||||||
|
### Entry Editing Flow
|
||||||
|
- Inline expand: clicking entry expands it in place to show edit fields
|
||||||
|
- No page navigation or modal for editing
|
||||||
|
- Auto-save: changes save as you type (debounced)
|
||||||
|
- Delete: swipe to delete gesture (mobile-friendly)
|
||||||
|
- Adding notes: append to content field (no separate notes section)
|
||||||
|
|
||||||
|
### Task Completion
|
||||||
|
- Checkbox to mark complete
|
||||||
|
- Completed tasks disappear from main list (hidden by default)
|
||||||
|
- Toggle in UI to show/hide completed tasks
|
||||||
|
|
||||||
|
### Claude's Discretion
|
||||||
|
- Exact swipe gesture implementation
|
||||||
|
- Auto-save debounce timing
|
||||||
|
- Visual design of type indicators
|
||||||
|
- Animation timing for highlight effect
|
||||||
|
- Responsive breakpoint for card vs compact switch
|
||||||
|
|
||||||
|
</decisions>
|
||||||
|
|
||||||
|
<specifics>
|
||||||
|
## Specific Ideas
|
||||||
|
|
||||||
|
- Bottom capture bar should feel natural on mobile — like messaging app input
|
||||||
|
- Entry expansion should be smooth, not jarring
|
||||||
|
- Type indicator should be obvious at a glance (tasks actionable, thoughts reference)
|
||||||
|
- Font sizes must accommodate older eyes (minimum 16px base as per requirements)
|
||||||
|
|
||||||
|
</specifics>
|
||||||
|
|
||||||
|
<deferred>
|
||||||
|
## Deferred Ideas
|
||||||
|
|
||||||
|
None — discussion stayed within phase scope.
|
||||||
|
|
||||||
|
</deferred>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Phase: 02-core-crud*
|
||||||
|
*Context gathered: 2026-01-29*
|
||||||
Reference in New Issue
Block a user