System Logic Reference

Complete documentation of ForaCity's compliance engines, detection pipelines, sync workflows, and alert systems. Each section describes the business rules, data flow, and implementation details.

California Levine Act (Gov. Code § 84308)

The Levine Act prohibits elected officials from participating in decisions affecting contributors who gave $500+ within 12 months. ForaCity implements the full compliance framework including threshold tracking, lookback windows, cure provisions, and exemptions.

Core Rules

$500+

Contribution Threshold

Any single contribution of $500 or more from a source triggers Levine Act tracking. Officers must disclose and potentially recuse.

Gov. Code § 84308(a)

$500+

Recusal Threshold

If an officer received $500+ from a party/participant in a proceeding within the past 12 months, the officer must recuse from that proceeding.

Gov. Code § 84308(c)

12 months

Lookback Window

Contributions are evaluated within a rolling 12-month window preceding the date of the proceeding. Contributions outside this window do not trigger recusal.

Gov. Code § 84308(c)

30 days

Cure Provision

An officer may 'cure' a conflict by returning the contribution within 30 days of learning about the conflict. The return must be documented and the full amount returned.

Gov. Code § 84308(d)

3 months

Solicitation Ban

Officers may not solicit or accept contributions of $500+ from a party/participant for 3 months following the proceeding.

Gov. Code § 84308(e)

Full

Agent Attribution

Contributions from agents, lobbyists, or representatives acting on behalf of a party are attributed to the party. The system tracks agent-principal relationships.

Gov. Code § 84308(a)(4)

Per source

Aggregation

Multiple contributions from the same source are aggregated. If the total from one source exceeds $500 within 12 months, the threshold is triggered.

FPPC Regulation 18438.5

Exemptions

General Legislation

Proceedings that apply to all residents equally (e.g., citywide zoning changes, general tax measures) are exempt from Levine Act restrictions.

§ 84308(a)(1)

Ministerial Actions

Actions that require no discretion (e.g., issuing a building permit that meets all code requirements) are exempt.

§ 84308(a)(2)

Emergency Actions

Actions taken in response to declared emergencies are exempt from the 12-month lookback.

§ 84308(a)(3)

Competitive Bidding

Proceedings decided solely through competitive bidding processes are exempt.

§ 84308(a)(4)

Implementation Files

server/compliance-engine.ts— Core detection logic

server/compliance-db.ts— DB queries

server/compliance-ai.ts— LLM analysis

server/compliance-router.ts— API endpoints

drizzle/schema.ts— conflicts, complianceEvents, complianceScores

server/routers.ts— netfile.detectConflicts, netfile.detectAll