How xeonica/seoul-place-docent works
This is a Seoul place-history docent and research archive, with a public MCP interface alongside the web app. The main visitor flow resolves an address, verifies the selected candidate, and returns place context such as regional history, buildings, and coordinates; AI summaries are a separate optional result. The archive supports source research, photo/video collections, and review workflows for captured material and regional or passage evidence. The graph follows documented routes and imports; many unsampled endpoints and integrations are omitted where their connections cannot be verified.
Main entry points: mcp/route.ts MCP request handler · providers.ts Address and building data · task/route.ts Archive review tasks · place/route.ts Place lookup
Components 27
Place exploration
- Place lookup
app/api/place/route.ts - AI summary route
app/api/ai-summary/route.ts
History archive
- Archive explorer
app/archive/page.tsx - Document research
app/archive/document-research/document-research.tsx - Document research API
app/api/archive/document-research/route.ts - Photo research
app/archive/photo-research/photo-research.tsx - Photo preview
app/components/PhotoPreview.tsx - Video research
app/archive/video-research/video-research.tsx - Archive review tasks
app/api/archive/task/route.ts
MCP interface
- MCP request handler
app/mcp/route.ts
Domain services
- Address and building data
lib/providers.ts - Regional history
lib/history.ts - AI summaries
lib/ai-summary.ts - Photo research data
lib/photo-research.ts - Archive database
lib/archive-db.ts - Capture imports
lib/archive-capture.ts - Region review
lib/archive-region-review.ts - Passage review
lib/archive-passage-review.ts - Archive validation
lib/archive-validation.ts - MCP protocol
lib/mcp-protocol.ts - Attached photo reading
lib/mcp-photo.ts - Photo location mapping
lib/mcp-map-address.ts - Answer validation
lib/place-answer.ts - MCP audit
lib/mcp-audit.ts
Other components
- Visitor
- Address and building providers
- AI provider
Connections 29
- Visitor → Place lookup: requests place
app/api/place/route.ts - Place lookup → Address and building data: verifies and queries
app/api/place/route.ts - Place lookup → Regional history: matches regions
app/api/place/route.ts - Address and building data → Address and building providers: fetches records
lib/providers.ts - Visitor → AI summary route: requests summary
app/api/ai-summary/route.ts - AI summary route → Address and building data: verifies address
app/api/ai-summary/route.ts - AI summary route → AI summaries: generates summary
app/api/ai-summary/route.ts - AI summaries → Regional history: uses history
lib/ai-summary.ts - AI summaries → AI provider: generates text
- Visitor → Archive explorer: browses research
app/archive/page.tsx - Archive explorer → Document research: opens research
app/archive/page.tsx - Document research → Document research API: loads research
app/archive/document-research/document-research.tsx - Visitor → Photo research: browses photos
app/archive/photo-research/photo-research.tsx - Photo research → Photo research data: filters records
app/archive/photo-research/photo-research.tsx - Photo research → Photo preview: renders preview
app/archive/photo-research/photo-research.tsx - Archive explorer → Video research: opens video research
app/archive/page.tsx - Archive review tasks → Archive database: reads archive
app/api/archive/task/route.ts - Archive review tasks → Capture imports: imports captures
app/api/archive/task/route.ts - Archive review tasks → Region review: verifies regions
app/api/archive/task/route.ts - Archive review tasks → Passage review: reviews passages
app/api/archive/task/route.ts - Region review → Address and building data: searches addresses
lib/archive-region-review.ts - Passage review → Archive validation: checks evidence
lib/archive-passage-review.ts - Visitor → MCP request handler: calls MCP tools
app/mcp/route.ts - MCP request handler → MCP protocol: formats results
app/mcp/route.ts - MCP request handler → Attached photo reading: reads attachment
app/mcp/route.ts - MCP request handler → Photo location mapping: maps photo location
app/mcp/route.ts - MCP request handler → Answer validation: validates answers
app/mcp/route.ts - MCP request handler → Address and building data: searches and verifies
app/mcp/route.ts - MCP request handler → MCP audit: records audit
app/mcp/route.ts