KCI-KANBAN/skills.md

Skills And Lessons Learned

Runtime And Driver Bitness

• This project depends on a 32-bit Access driver path.
• Run IIS Express as 32-bit for local app runtime:
  • %ProgramFiles(x86)%\IIS Express\iisexpress.exe
• applicationhost.config should keep enable32BitAppOnWin64="true" on the active app pool.
• Running 64-bit IIS Express or 64-bit script host can trigger:
  • Provider cannot be found (3706)
  • Data source name not found and no default driver specified

Migration Runner Usage

• scripts\runMigrations.vbs must be executed with 32-bit cscript on this machine:
  • C:\Windows\SysWOW64\cscript.exe //nologo scripts\runMigrations.vbs up
• The standalone migration context differs from IIS runtime context:
  • Do not assume migration.DB.Execute / migration.DB.Query always exist.
  • Prefer migration helpers that can fall back to migration.Connection + ADODB.Command.

Flash API Contract

• Flash_Class supports:
  • AddError "message"
  • Success = "message"
• SetError and SetSuccess are not valid methods and cause 438.

Linked List Node API

• LinkedList_Node_Class uses fields:
  • m_value
  • m_next
• Using .Value or .Next causes Object doesn't support this property or method (438).

Keycloak User Object Handling

• Treat KeycloakCurrentUser() defensively.
• Do not rely on .Exists(...) being available in every execution path.
• Safe pattern:
  • Try Item("preferred_username") under On Error Resume Next
  • Fallback to Item("email")

Navigation Pattern

• Top nav should include a direct Boards link.
• Use Active("controller") for active CSS state (for example home, boards).