Files
personal-portfolio/docs/project-lessons-learned/INDEX.md
lmiranda c9cf744d84 feat: Complete Phase 5 dashboard implementation
Implement full 5-tab Toronto Neighbourhood Dashboard with real data
connectivity:

Dashboard Structure:
- Overview tab with livability scores and rankings
- Housing tab with affordability metrics
- Safety tab with crime statistics
- Demographics tab with population/income data
- Amenities tab with parks, schools, transit

Figure Factories (portfolio_app/figures/):
- bar_charts.py: ranking, stacked, horizontal bars
- scatter.py: scatter plots, bubble charts
- radar.py: spider/radar charts
- demographics.py: donut, age pyramid, income distribution

Service Layer (portfolio_app/toronto/services/):
- neighbourhood_service.py: queries dbt marts for all tab data
- geometry_service.py: generates GeoJSON from PostGIS
- Graceful error handling when database unavailable

Callbacks (portfolio_app/pages/toronto/callbacks/):
- map_callbacks.py: choropleth updates, map click handling
- chart_callbacks.py: supporting chart updates
- selection_callbacks.py: dropdown handlers, KPI updates

Data Pipeline (scripts/data/):
- load_toronto_data.py: orchestration script with CLI flags

Lessons Learned:
- Graceful error handling in service layers
- Modular callback structure for multi-tab dashboards
- Figure factory pattern for reusable charts

Closes: #64, #65, #66, #67, #68, #69, #70

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 11:46:18 -05:00

1.7 KiB

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-01-17 Sprint 9-10 Graceful Error Handling in Service Layers python, postgresql, error-handling, dash, graceful-degradation, arm64
2026-01-17 Sprint 9-10 Modular Callback Structure dash, callbacks, architecture, python, code-organization
2026-01-17 Sprint 9-10 Figure Factory Pattern plotly, dash, design-patterns, python, visualization
2026-01-16 Phase 4 dbt Test Syntax Deprecation 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

# [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]