feat: add contribution opportunity workflow

[arnabnandy7]

Summary

Add a private contribution workflow board for signed-in users to organize and follow saved opportunities through their contribution lifecycle.

Closes #55.

Changes

• Added workflow states:
  • Saved
  • Asked maintainer
  • Working
  • PR opened
  • Merged
  • Abandoned
• Added a signed-in-only Workflow tab.
• Grouped and filtered opportunities by workflow state.
• Added optional private notes and follow-up dates.
• Added configurable stale-opportunity highlighting.
• Extended the existing opportunity API with user-scoped workflow updates.
• Reused the existing opportunity persistence and authenticated tab flows.
• Preserved safe contribution matching: issue and pull-request numbers are never treated as links without an explicit relationship.
• Updated architecture, setup, deployment, and feature documentation.

Database changes

Added db/migrations/0012_opportunity_workflow.sql, which extends opportunity with:

• workflow_state
• note
• follow_up_at
• workflow_updated_at
• Composite index on user_id and workflow_state

Existing opportunities are initialized as saved, with workflow_updated_at backfilled from updated_at.

The migration has been applied and verified in both preview and production databases.

Privacy and validation

• Workflow records remain scoped to the authenticated user.
• Notes are limited to 2,000 characters.
• Workflow states and follow-up dates are validated server-side.
• Guests retain the existing discovery experience without access to workflow data.

Verification

Manual checks:

• Save an opportunity and open the Workflow tab.
• Change its state and refresh the page.
• Add, edit, and remove a private note.
• Set and clear a follow-up date.
• Filter opportunities by state.
• Change the stale threshold and verify highlighting.
• Confirm guests cannot access the Workflow tab.
• Confirm another authenticated user cannot update the opportunity.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
openissue-dev	Ready	Preview	Aug 31, 2026 7:11pm

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
96.7% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud