I Escondido·In 8 weeks (June 2026)
ForaCity Developer Portal
Back to Architecture

Main Public Site

foracity.com

The primary public-facing civic engagement platform. Houses the Levine Act compliance guide, Fora proposal system, official profiles, meeting tracker, legislation browser, voter guide, and candidate comparison tools.

General public, citizens, voters, civic advocates
12
Pages
14
Router Groups
10
Key Tables
5
Integrations

Pages & Routes

Home
/
Levine Act compliance guide with 9 sections, sticky TOC, animated hero
Fora
/fora
Citizen proposal forum — browse, create, vote on proposals
Proposal Workspace
/proposals/:id
Deep-dive proposal editor with 8 tabs: overview, solutions, arguments, research, funding, campaigns, timeline, committee
Officials
/officials
Elected official directory with compliance scores
Meetings
/meetings
City council meeting tracker with agendas and minutes
Legislation
/legislation
Legislation browser with search and status tracking
Voter Guide
/vote
2026 election guide — all races, key dates, top issues, debate recaps
Candidate Compare
/compare
Side-by-side candidate comparison with Values Compass alignment
District 1 Race Tracker
/races/district-1
Contested race tracker — debates, positions, voter Q&A, Fora proposals
I Heart Escondido
/iheartescondido
Community service event page
Citizen Profile
/profile
Personal civic dashboard with activity, values, followed officials
Values Compass
/values
Civic values assessment tool for matching to candidates/proposals

API Routers & Procedures

auth

Authentication state and session management

me()logout()
jurisdictions

Government jurisdiction lookup

list()getById()
officers

Elected official data

list()getById()search()
contributions

Political contribution records

list()getByOfficer()search()stats()
proceedings

Government proceedings and agenda items

list()getById()search()
conflicts

Conflict of interest detection

list()getByOfficer()detect()analyze()
meetings

Meeting tracking with AI analysis

list()getById()analyze()summarize()
forum

Fora proposal system — full CRUD with AI research

list()getById()create()vote()addSolution()addArgument()aiResearch()aiSuggestQueries()
values

Values Compass assessment and matching

getProfile()saveProfile()matchCandidates()
feed

Civic newsfeed aggregation

getFeed()getActivity()
news

News with AI summarization

list()summarize()
accountability

Official accountability tracking

getScorecard()getTimeline()
leaderboard

Citizen engagement leaderboard

getCivicLeaders()
civicGuides

Civic education content

list()getById()

Database Tables

usersCentral identity for all authenticated users
citizenProfilesExtended civic profile with Values Compass data
forumProposalsCore proposal records
proposalSolutionsProposed solutions within proposals
proposalArgumentsPro/con arguments on proposals
contributionsPolitical contribution records
officersElected official profiles
proceedingsGovernment proceedings
conflictsDetected conflicts of interest
communityEventsCommunity events (I Heart Escondido)

Integrations

Manus OAuthAuth
active
Manus Forge LLMAI
active
TiDBDatabase
active
S3 StorageStorage
active
NetFile FPPCCompliance
active

AI Usage & Guardrails

Conflict AnalysisForge LLM

Analyze potential conflicts between contributions and proceedings

Read-only analysis, no auto-actions. Human review required for all flagged conflicts.

Meeting SummarizationForge LLM

Generate meeting summaries and extract key decisions

Output marked as AI-generated. No modification of official records.

News SummarizationForge LLM

Summarize news articles for civic feed

Source attribution required. Summaries link to original articles.

Forum AI ResearchForge LLM

Research context and data for citizen proposals

Research suggestions only — citizens must review and approve. No auto-publishing.

Forum AI QueriesForge LLM

Suggest research queries for proposal authors

Suggestions only, no auto-execution of queries.