How huyanxius/qunxue works
群学致知 is a sociology research-discovery and design workbench. Its documented user journey moves from a phenomenon or research material through Agent-supported exploration, knowledge review, researcher-led theory judgment, and a revisable research framework. The graph combines that documented journey with the visible application entry points, research-task API, persistence, and delivery interactions. Some major capabilities are documented but their implementation was not sampled, so those links are documented rather than inferred from module names.
Main entry points: App.tsx Web application · M5ResearchDeliveryController.tsx Research delivery · ResearchMaterialsPage.tsx Materials library · theory_matching.py Theory matching
Components 22
Web workbench
- Web application
frontend/src/app/App.tsx - New research
frontend/src/app/agent/NewResearchWorkspacePage.tsx - Research workspace
frontend/src/app/research-workspace/ResearchProjectWorkspacePage.tsx - Materials library
frontend/src/app/research/ResearchMaterialsPage.tsx - Knowledge exploration
frontend/src/app/KnowledgeGraphIntegration.tsx - Delivery API client
frontend/src/api/m5ResearchDelivery.ts - Agent client
frontend/src/modules/research-agent/index.ts
Research workflow
- Phenomenon intake
backend/src/qunxue_api/modules/research_intake/service.py - Research Agent
backend/src/qunxue_api/application/agent_research_workflow.py - Theory matching
backend/src/qunxue_api/application/theory_matching.py - Research framework
backend/src/qunxue_api/modules/research_framework/proposals.py - Research delivery
frontend/src/app/research-workspace/M5ResearchDeliveryController.tsx
Knowledge and analysis
- Versioned knowledge
backend/src/qunxue_api/modules/knowledge_catalog/public.py - Frontier knowledge
backend/src/qunxue_api/application/frontier_pipeline.py - Qualitative analysis
backend/src/qunxue_api/modules/research_analysis/service.py - Research materials
backend/src/qunxue_api/modules/research_materials/service.py
API and persistence
- Research task API
backend/src/qunxue_api/api/routes/research_tasks.py - Task domain
backend/src/qunxue_api/modules/research_intake/service.py - Analysis repository
backend/src/qunxue_api/adapters/sqlite/research_analysis_repository.py - Material repository
backend/src/qunxue_api/adapters/sqlite/research_material_repository.py - SQLite database
backend/src/qunxue_api/adapters/sqlite/base.py
Other components
- Researcher
Connections 22
- Researcher → Web application: uses
README.md - Web application → New research: routes to
frontend/src/app/App.tsx - Web application → Research workspace: routes to
frontend/src/app/App.tsx - Web application → Materials library: routes to
frontend/src/app/App.tsx - Web application → Knowledge exploration: routes to
frontend/src/app/App.tsx - Researcher → Phenomenon intake: describes phenomenon
README.md - Phenomenon intake → Research Agent: continues with
- Research Agent → Versioned knowledge: uses knowledge tools
README.md - Versioned knowledge → Theory matching: informs comparison
README.md - Researcher → Theory matching: chooses theory
README.md - Theory matching → Research framework: organizes judgment
README.md - Researcher → Materials library: reviews materials
README.md - Materials library → Research materials: accesses
- Knowledge exploration → Versioned knowledge: explores
- Researcher → Frontier knowledge: explores frontier
README.md - Researcher → Qualitative analysis: analyzes research
- Research workspace → Research delivery: hosts delivery
README.md - Research delivery → Delivery API client: loads and mutates
frontend/src/app/research-workspace/M5ResearchDeliveryController.tsx - Research delivery → Agent client: streams agent turn
frontend/src/app/research-workspace/M5ResearchDeliveryController.tsx - Research task API → Task domain: calls service
backend/src/qunxue_api/api/routes/research_tasks.py - Analysis repository → SQLite database: executes writes
backend/src/qunxue_api/adapters/sqlite/research_analysis_repository.py - Material repository → SQLite database: reads and writes
backend/src/qunxue_api/adapters/sqlite/research_material_repository.py