Add a democratic idea submission and AI synthesis platform

Implement a full-stack application with a React frontend and a Python Flask backend. The backend integrates with an AI agent to filter political ideas for democratic values and synthesize accepted ideas into a collective voice. Includes API endpoints for idea submission, retrieval, and synthesis, along with database persistence.

Replit-Commit-Author: Agent
Replit-Commit-Session-Id: 923ae0e3-a363-4db8-b04a-e8baca2a1330
Replit-Commit-Checkpoint-Type: full_checkpoint
Replit-Commit-Event-Id: 31c5f770-9905-46af-a938-9d40ef3d4404
Replit-Commit-Screenshot-Url: https://storage.googleapis.com/screenshot-production-us-central1/8af7d2ec-2cc3-4ece-8af3-9f071488d072/923ae0e3-a363-4db8-b04a-e8baca2a1330/Xzzm5QH
Replit-Helium-Checkpoint-Created: true

lib/api-spec/openapi.yaml

@@ -10,6 +10,10 @@ servers:
 tags:
   - name: health
     description: Health operations
+  - name: ideas
+    description: Civic idea submission and management
+  - name: synthesis
+    description: AI synthesis of the people's voice
 paths:
   /healthz:
     get:
@@ -24,6 +28,75 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/HealthStatus"
+
+  /ideas:
+    post:
+      operationId: submitIdea
+      tags: [ideas]
+      summary: Submit a political idea
+      description: Submit a civic idea to be filtered and included in the synthesis
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SubmitIdeaBody"
+      responses:
+        "201":
+          description: Idea submitted
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IdeaResult"
+        "400":
+          description: Bad request
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ErrorResponse"
+    get:
+      operationId: listIdeas
+      tags: [ideas]
+      summary: List all accepted ideas
+      description: Returns all ideas that passed the democratic filter
+      responses:
+        "200":
+          description: List of accepted ideas
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/Idea"
+
+  /ideas/stats:
+    get:
+      operationId: getIdeaStats
+      tags: [ideas]
+      summary: Get idea statistics
+      description: Returns counts of total, accepted and rejected ideas
+      responses:
+        "200":
+          description: Stats
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/IdeaStats"
+
+  /synthesis:
+    get:
+      operationId: getSynthesis
+      tags: [synthesis]
+      summary: Get current synthesis
+      description: Returns the latest synthesized text of the people's voice
+      responses:
+        "200":
+          description: Current synthesis
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Synthesis"
+
 components:
   schemas:
     HealthStatus:
@@ -34,3 +107,99 @@ components:
       required:
         - status
 
+    SubmitIdeaBody:
+      type: object
+      properties:
+        content:
+          type: string
+          minLength: 10
+          maxLength: 1000
+          description: The political idea text
+        author:
+          type: string
+          maxLength: 100
+          description: Optional pseudonym
+      required:
+        - content
+
+    IdeaResult:
+      type: object
+      properties:
+        id:
+          type: integer
+        accepted:
+          type: boolean
+        reason:
+          type: string
+          description: Reason if rejected
+        idea:
+          $ref: "#/components/schemas/Idea"
+      required:
+        - id
+        - accepted
+
+    Idea:
+      type: object
+      properties:
+        id:
+          type: integer
+        content:
+          type: string
+        author:
+          type: string
+          nullable: true
+        accepted:
+          type: boolean
+        rejectionReason:
+          type: string
+          nullable: true
+        createdAt:
+          type: string
+          format: date-time
+      required:
+        - id
+        - content
+        - accepted
+        - createdAt
+
+    IdeaStats:
+      type: object
+      properties:
+        total:
+          type: integer
+        accepted:
+          type: integer
+        rejected:
+          type: integer
+      required:
+        - total
+        - accepted
+        - rejected
+
+    Synthesis:
+      type: object
+      properties:
+        text:
+          type: string
+          description: The synthesized voice of the people
+        ideaCount:
+          type: integer
+          description: Number of ideas included in the synthesis
+        updatedAt:
+          type: string
+          format: date-time
+          nullable: true
+      required:
+        - text
+        - ideaCount
+
+    ErrorResponse:
+      type: object
+      properties:
+        error:
+          type: string
+        message:
+          type: string
+      required:
+        - error
+        - message