How parts345/inkloom-ai works
Inkloom AI is a pre-publication brand-governance workspace: creators submit content, the backend analyzes it, and users review findings and decisions; separate views expose brand knowledge and governance analytics. The README describes extraction, deterministic checks, LLM verification, and persistence as interface stubs, so the graph shows those documented stages without assuming implementation details beyond the excerpts. Frontend-to-backend links are marked unverified because the excerpts do not show the complete request/route mapping.
Main entry points: submissions.py Submission routes · api.ts API client · App.tsx Workspace navigation · orchestrator.py Analysis orchestrator
Components 21
Workspace UI
- Workspace navigation
frontend/src/App.tsx - New submission
frontend/src/pages/NewSubmissionView.tsx - Review workspace
frontend/src/pages/SubmissionReviewView.tsx - Brand knowledge
frontend/src/pages/BrandKnowledgeView.tsx - Governance analytics
frontend/src/pages/GovernanceAnalyticsView.tsx - Review components
frontend/src/pages/ui.tsx
Submission API
- API client
frontend/src/api.ts - Mock API
frontend/src/mock.ts - Submission routes
backend/app/routers/submissions.py - Demo roles
backend/app/routers/demo.py - API contracts
backend/app/schemas.py
Content Analysis
- Analysis orchestrator
backend/app/services/orchestrator.py - Content extraction
backend/app/services/extraction.py - Deterministic checks
backend/app/services/deterministic.py - LLM verification
backend/app/services/verification.py
Governance State
- Analysis persistence
backend/app/services/persistence.py - SQL database
backend/app/database.py - Governance records
backend/app/models.py - Demo workspace seed
backend/app/seed.py
Other components
- Workspace user
- FastAPI application
backend/app/main.py
Connections 36
- Workspace user → Workspace navigation: uses
README.md - Workspace navigation → New submission: shows
frontend/src/App.tsx - Workspace navigation → Review workspace: shows
frontend/src/App.tsx - Workspace navigation → Brand knowledge: shows
frontend/src/App.tsx - Workspace navigation → Governance analytics: shows
frontend/src/App.tsx - Workspace navigation → API client: loads submissions
frontend/src/App.tsx - Review workspace → Review components: renders
frontend/src/pages/SubmissionReviewView.tsx - Review workspace → API client: requests actions
frontend/src/pages/SubmissionReviewView.tsx - New submission → API client: creates submission
frontend/src/pages/NewSubmissionView.tsx - Brand knowledge → API client: requests knowledge
frontend/src/pages/BrandKnowledgeView.tsx - Governance analytics → API client: requests data
frontend/src/pages/GovernanceAnalyticsView.tsx - API client → Mock API: delegates in mock mode
frontend/src/api.ts - API client → Submission routes: sends HTTP requests
- FastAPI application → Submission routes: registers
backend/app/main.py - FastAPI application → Demo roles: registers
backend/app/main.py - Submission routes → Demo roles: resolves actor
backend/app/routers/submissions.py - Submission routes → Analysis orchestrator: analyzes submission
backend/app/routers/submissions.py - Submission routes → Analysis persistence: reads and writes
backend/app/routers/submissions.py - Submission routes → SQL database: uses sessions
backend/app/routers/submissions.py - Submission routes → Governance records: queries records
backend/app/routers/submissions.py - Submission routes → API contracts: validates payloads
backend/app/routers/submissions.py - Analysis orchestrator → Content extraction: extracts units
backend/app/services/orchestrator.py - Analysis orchestrator → Deterministic checks: runs checks
backend/app/services/orchestrator.py - Analysis orchestrator → LLM verification: verifies units
backend/app/services/orchestrator.py - Analysis orchestrator → Analysis persistence: persists results
backend/app/services/orchestrator.py - Analysis orchestrator → API contracts: uses data types
backend/app/services/orchestrator.py - Analysis persistence → SQL database: opens sessions
backend/app/services/persistence.py - Analysis persistence → Governance records: maps records
backend/app/services/persistence.py - Analysis persistence → API contracts: builds responses
backend/app/services/persistence.py - LLM verification → Governance records: loads knowledge
backend/app/services/verification.py - LLM verification → API contracts: builds findings
backend/app/services/verification.py - FastAPI application → SQL database: initializes
backend/app/main.py - FastAPI application → Demo workspace seed: loads demo data
backend/app/main.py - Demo workspace seed → Analysis persistence: stores seed data
backend/app/seed.py - Demo workspace seed → Governance records: creates records
backend/app/seed.py - Demo workspace seed → SQL database: uses sessions
backend/app/seed.py