Align db contract with neon schema

[badjoke-lab]

Summary

• add reusable db/data-source helpers and expose db-backed places endpoints that map neon columns to lat/lng
• update MapShell to use the db API when NEXT_PUBLIC_DATA_SOURCE=db while keeping existing JSON mode intact
• document the actual schema, contract diffs, and ETL/country-normalization decisions

Testing

• not run (not requested)

---

Codex Task

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
cryptopaymap	Error			Nov 23, 2025 4:56pm

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Install pg before using Pool

src/lib/db.ts now imports Pool from pg, but the package manifest/pnpm lock contain no pg entry and node_modules/pg is absent. When the new DB-backed routes (/api/places or /api/db/places) run in db mode, the server will fail to start with Cannot find module 'pg' before any query executes. Add the dependency or the DB paths remain unusable.

Useful? React with 👍 / 👎.