l3ocho
a5d6866d63
Some checks failed
CI / lint-and-test (push) Has been cancelled
- Enable contact form fields with component IDs - Add callback for Formspree POST with JSON/AJAX - Include honeypot spam protection (_gotcha field) - Handle validation, loading, success/error states - Clear form on successful submission - Add lessons learned documentation Closes #92, #93, #94 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
57 lines
2.2 KiB
Markdown
57 lines
2.2 KiB
Markdown
# Project Lessons Learned
|
|
|
|
This folder contains lessons learned from sprints and development work. These lessons help prevent repeating mistakes and capture valuable insights.
|
|
|
|
**Note:** This is a temporary local backup while Wiki.js integration is being configured. Once Wiki.js is ready, lessons will be migrated there for better searchability.
|
|
|
|
---
|
|
|
|
## Lessons Index
|
|
|
|
| Date | Sprint/Phase | Title | Tags |
|
|
|------|--------------|-------|------|
|
|
| 2026-02-01 | Sprint 10 | [Formspree Integration with Dash Callbacks](./sprint-10-formspree-dash-integration.md) | formspree, dash, callbacks, forms, spam-protection, honeypot, ajax |
|
|
| 2026-01-17 | Sprint 9 | [Gitea Labels API Requires Org Context](./sprint-9-gitea-labels-user-repos.md) | gitea, mcp, api, labels, projman, configuration |
|
|
| 2026-01-17 | Sprint 9 | [Always Read CLAUDE.md Before Asking Questions](./sprint-9-read-claude-md-first.md) | projman, claude-code, context, documentation, workflow |
|
|
| 2026-01-17 | Sprint 9-10 | [Graceful Error Handling in Service Layers](./sprint-9-10-graceful-error-handling.md) | python, postgresql, error-handling, dash, graceful-degradation, arm64 |
|
|
| 2026-01-17 | Sprint 9-10 | [Modular Callback Structure](./sprint-9-10-modular-callback-structure.md) | dash, callbacks, architecture, python, code-organization |
|
|
| 2026-01-17 | Sprint 9-10 | [Figure Factory Pattern](./sprint-9-10-figure-factory-pattern.md) | plotly, dash, design-patterns, python, visualization |
|
|
| 2026-01-16 | Phase 4 | [dbt Test Syntax Deprecation](./phase-4-dbt-test-syntax.md) | dbt, testing, yaml, deprecation |
|
|
|
|
---
|
|
|
|
## How to Use
|
|
|
|
### When Starting a Sprint
|
|
1. Review relevant lessons in this folder before implementation
|
|
2. Search by tags or keywords to find applicable insights
|
|
3. Apply prevention strategies from past lessons
|
|
|
|
### When Closing a Sprint
|
|
1. Document any significant lessons learned
|
|
2. Use the template below
|
|
3. Add entry to the index table above
|
|
|
|
---
|
|
|
|
## Lesson Template
|
|
|
|
```markdown
|
|
# [Sprint/Phase] - [Lesson Title]
|
|
|
|
## Context
|
|
[What were you trying to do?]
|
|
|
|
## Problem
|
|
[What went wrong or what insight emerged?]
|
|
|
|
## Solution
|
|
[How did you solve it?]
|
|
|
|
## Prevention
|
|
[How can this be avoided in future sprints?]
|
|
|
|
## Tags
|
|
[Comma-separated tags for search]
|
|
```
|