How antrow15/newsmindai works
NewsMind is a newsroom backend with a console and role-oriented FastAPI APIs. Users authenticate, then use newsroom desks for ingestion and cleaning, editorial review and assignment, audience analysis, content adaptation, and publication. The README documents the main capabilities and training flow; sampled source confirms several internal calls and the PostgreSQL persistence layer. Some desk implementations and API routes were not sampled, so those links rely on README-level architecture rather than inspected route code.
Main entry points: routers Role APIs · dao Data access · ingestion_service.py CSV ingestion · auth_service.py Authentication
Components 19
User entry
- Console menus
app.py - Role APIs
api/routers - Authentication
modules/authentication/auth_service.py
Newsroom workflow
- CSV ingestion
services/ingestion_service.py - Cleaning stages
cleaners/pipeline.py - Content desk
services/content/content_service.py - Journalist tools
services/journalist - Editor desk
services/editor/editor_service.py - Manager desk
services/manager/manager_service.py - Publisher desk
services/publisher/publisher_service.py
ML capabilities
- Audience analysis
services/aia/aia_service.py - Content adaptation
services/adaptation/adaptation_service.py - ML capabilities
ml - ML training ingest
ml/training/ingest_clean.py
Persistence
- Repositories
repository/content_repository.py - User repository
repository/user_repository.py - Data access
dao - PostgreSQL
database/connection.py
Other components
- Newsroom user
Connections 23
- Newsroom user → Role APIs: uses role APIs
- Newsroom user → Console menus: uses menus
- Role APIs → Authentication: authenticates through
api/main.py - Console menus → Authentication: uses authentication
app.py - Role APIs → CSV ingestion: offers newsroom pipeline
- Role APIs → Journalist tools: exposes journalist tools
- Role APIs → Audience analysis: exposes AIA desk
- Role APIs → Content adaptation: exposes CAE desk
- Role APIs → Editor desk: exposes editor desk
- Role APIs → Manager desk: exposes manager desk
- Role APIs → Publisher desk: exposes publisher desk
- CSV ingestion → Cleaning stages: hands off for cleaning
- ML training ingest → Cleaning stages: reuses cleaners
ml/training/ingest_clean.py - Editor desk → ML capabilities: uses editor ML
services/editor/editor_service.py - Audience analysis → ML capabilities: uses AIA ML
services/aia/aia_service.py - Content adaptation → ML capabilities: uses adaptation ML
services/adaptation/adaptation_service.py - CSV ingestion → Data access: registers ingested files
services/ingestion_service.py - Content desk → Repositories: uses content repository
services/content/content_service.py - Repositories → Data access: delegates data access
repository/content_repository.py - User repository → Data access: delegates user access
repository/user_repository.py - Authentication → User repository: loads user profiles
modules/authentication/auth_service.py - Data access → PostgreSQL: queries database
dao/base_dao.py - PostgreSQL → Data access: returns query rows
database/connection.py