This commit is contained in:
alex wiesner
2026-03-13 20:15:22 +00:00
parent e68c95b2dd
commit c4d39f2812
33 changed files with 2383 additions and 162 deletions

View File

@@ -1,3 +1,9 @@
---
title: conventions
type: note
permalink: voyage/knowledge/conventions
---
# Coding Conventions & Patterns
## Frontend Patterns
@@ -18,4 +24,4 @@
- Do **not** attempt to fix known test/configuration issues as part of feature work
- Use `bun` for frontend commands, `uv` for local Python tooling where applicable
- Commit and merge completed feature branches promptly once validation passes (avoid leaving finished work unmerged)
- See [decisions.md](../decisions.md#workflow-preference-commit--merge-when-done) for rationale
- See [decisions.md](../decisions.md#workflow-preference-commit--merge-when-done) for rationale

View File

@@ -1,3 +1,9 @@
---
title: ai-configuration
type: note
permalink: voyage/knowledge/domain/ai-configuration
---
# AI Configuration Domain
## WS1 Configuration Infrastructure
@@ -41,4 +47,4 @@ Three compounding issues (all resolved):
| Fallback key | `backend/server/chat/llm_client.py` | `get_llm_api_key()` |
| UserAISettings model | `backend/server/integrations/models.py` | after UserAPIKey |
| Catalog user flags | `backend/server/chat/llm_client.py` | `get_provider_catalog()` |
| Provider view | `backend/server/chat/views/__init__.py` | `ChatProviderCatalogViewSet` |
| Provider view | `backend/server/chat/views/__init__.py` | `ChatProviderCatalogViewSet` |

View File

@@ -1,3 +1,9 @@
---
title: collections-and-sharing
type: note
permalink: voyage/knowledge/domain/collections-and-sharing
---
# Collections & Sharing Domain
## Collection Sharing Architecture
@@ -65,4 +71,4 @@ Backend-only feature: model, API, and system-prompt integration exist, but **no
### Frontend Gap
- No settings tab for manual preference editing
- TypeScript type available as `UserRecommendationPreferenceProfile` in `src/lib/types.ts`
- See [Plan: AI travel agent redesign](../../plans/ai-travel-agent-redesign.md#ws2-user-preference-learning)
- See [Plan: AI travel agent redesign](../../plans/ai-travel-agent-redesign.md#ws2-user-preference-learning)

View File

@@ -1,3 +1,9 @@
---
title: overview
type: note
permalink: voyage/knowledge/overview
---
# Architecture Overview
## API Proxy Pattern
@@ -40,4 +46,4 @@ Session-based via `django-allauth`. CSRF tokens from `/auth/csrf/`, passed as `X
- i18n: `frontend/src/locales/`
- Docker config: `docker-compose.yml`, `docker-compose.dev.yml`
- CI/CD: `.github/workflows/`
- Public docs: `documentation/` (VitePress)
- Public docs: `documentation/` (VitePress)

View File

@@ -1,3 +1,9 @@
---
title: chat-and-llm
type: note
permalink: voyage/knowledge/patterns/chat-and-llm
---
# Chat & LLM Patterns
## Default AI Settings & Model Override
@@ -164,4 +170,4 @@ All tool functions: `def tool_name(user, **kwargs) -> dict`. Return `{"error": "
## WS4-F3 Add-to-itinerary from Chat
- `search_places` card results can be added directly to itinerary when collection context exists
- Flow: date selector modal -> `POST /api/locations/` -> `POST /api/itineraries/` -> `itemAdded` event
- Coordinate guard (`hasPlaceCoordinates`) required
- Coordinate guard (`hasPlaceCoordinates`) required

View File

@@ -1,3 +1,9 @@
---
title: tech-stack
type: note
permalink: voyage/knowledge/tech-stack
---
# Tech Stack & Development
## Stack
@@ -62,4 +68,4 @@ LLM provider keys stored per-user in DB (`UserAPIKey` model, `integrations/model
- Docker dev setup has frontend-backend communication issues (500 errors beyond homepage)
- Frontend check: 0 errors, 6 warnings expected (pre-existing in `CollectionRecommendationView.svelte` + `RegionCard.svelte`)
- Backend tests: 6/30 pre-existing failures (2 user email key errors + 4 geocoding API mocks)
- Local Python pip install fails (network timeouts) — use Docker
- Local Python pip install fails (network timeouts) — use Docker