How haixinnn05/news-next-door works
News Next Door turns civic planning documents and application updates into source-backed proposal pages, audio briefings, and text reminders. The core proposal workflow is document import, structured extraction with quote validation, team review and publication, then resident discovery and following. Separate branches cover live NYC Planning applications, city news, location search, and resident accounts. The README documents several integrations and capabilities not fully sampled; those links are shown where documented, while uncertain internal wiring is omitted.
Main entry points: app.ts HTTP API · extraction.ts Draft extraction · proposals.ts Review and publish · main.ts Process and workers
Components 25
Resident and team web
- Web app routes
web/src/App.tsx - Resident pages
web/src/pages - Team console
web/src/admin - Web API client
web/src/lib/api.ts
Proposal publishing
- Document import
server/services/documents.ts - Draft extraction
server/services/extraction.ts - Review and publish
server/services/proposals.ts - Address coverage
server/lib/addresses.ts - Location lookup
server/services/locate.ts - District boundaries
server/services/boundary.ts
Briefings and messaging
- Application briefings
server/services/appBriefings.ts - City briefings
server/services/cityBriefings.ts - Audio generation
server/services/audio.ts - Text subscriptions
server/services/subscriptions.ts - Reminder delivery
server/services/notifications.ts
Server platform
- HTTP API
server/http/app.ts - SQLite state
server/db.ts - Resident accounts
server/services/account.ts - Process and workers
server/main.ts
Other components
- Resident
- Review team
- Grok
- New York Times
- ElevenLabs
- Photon iMessage
Connections 31
- Resident → Web app routes: browses
- Review team → Team console: reviews drafts
- Web app routes → Resident pages: routes to
web/src/App.tsx - Web app routes → Team console: routes to
web/src/App.tsx - Resident pages → Web API client: requests data
web/src/pages/Proposal.tsx - Team console → Web API client: requests data
web/src/admin/ReviewPage.tsx - Web API client → HTTP API: calls
- HTTP API → Document import: imports document
server/http/app.ts - HTTP API → Draft extraction: extracts document
server/http/app.ts - Draft extraction → Document import: reads pages
server/services/extraction.ts - Draft extraction → Grok: requests draft
server/services/extraction.ts - Review team → Review and publish: approves publication
- Review and publish → Draft extraction: validates draft
server/services/proposals.ts - HTTP API → Review and publish: serves proposals
server/http/app.ts - Review and publish → Address coverage: matches locations
server/services/proposals.ts - HTTP API → Location lookup: looks up places
server/http/app.ts - HTTP API → District boundaries: loads boundary
server/http/app.ts - HTTP API → Resident accounts: loads saved proposals
server/http/app.ts - HTTP API → Text subscriptions: handles inbound texts
server/http/app.ts - Process and workers → HTTP API: starts server
server/main.ts - Process and workers → Reminder delivery: runs worker
server/main.ts - Process and workers → Application briefings: starts service
server/main.ts - Application briefings → Audio generation: generates audio
server/services/appBriefings.ts - Application briefings → Grok: generates versions
server/services/appBriefings.ts - City briefings → New York Times: gets headlines
- Audio generation → ElevenLabs: narrates and dubs
- Text subscriptions → Reminder delivery: schedules messages
server/services/subscriptions.ts - Reminder delivery → Photon iMessage: sends messages
- Document import → SQLite state: stores records
server/services/documents.ts - Draft extraction → SQLite state: stores drafts
server/services/extraction.ts - Review and publish → SQLite state: stores proposals
server/services/proposals.ts