How palemoky/chinese-poetry-api works
This repository is a Chinese-poetry data importer and read-only API service. The main workflow is to load source JSON, normalize and classify poems, build simplified and traditional SQLite datasets, then serve filtered, searchable, paginated results through REST or GraphQL. The graph also preserves the documented author, dynasty, type, statistics, language-selection, and random-poem capabilities. Internal links are limited to relationships shown in excerpts or the source index; some route-to-handler details are documented at the router level, while unsampled implementation links are omitted.
Main entry points: router.go REST routing · repository_poems.go Repository queries and writes · main.go Import command · pipeline.go Poem processing
Components 22
Data ingestion
- Import command
cmd/processor/main.go - JSON loader
internal/loader/json_loader.go - Poem processing
internal/processor/pipeline.go - Deduplication
internal/processor/finalize.go - Classification and conversion
internal/classifier
Persistence
- SQLite database
internal/database - Repository queries and writes
internal/database/repository_poems.go - Schema migration
internal/database/migrate.go
REST API
- HTTP server
cmd/server/main.go - Server configuration
internal/config/config.go - REST routing
internal/api/rest/router.go - Request middleware
internal/api/middleware - Poem search and lists
internal/api/rest/handler/poem.go - Author endpoints
internal/api/rest/handler/author.go - Dynasty endpoints
internal/api/rest/handler/dynasty.go - Poetry type endpoints
internal/api/rest/handler/poetry_type.go - Health and statistics
internal/api/rest/handler/health.go
GraphQL API
- GraphQL transport
internal/graph/server.go - GraphQL resolvers
internal/graph/schema.resolvers.go - Resolver dependencies
internal/graph/resolver.go
Other components
- API clients
- Poetry JSON corpus
Connections 31
- Poetry JSON corpus → Import command: supplies data
- Import command → JSON loader: loads JSON
cmd/processor/main.go - Import command → Poem processing: runs import
cmd/processor/main.go - Import command → SQLite database: opens and finalizes
cmd/processor/main.go - Poem processing → JSON loader: processes records
internal/processor/pipeline.go - Poem processing → Classification and conversion: normalizes text
internal/processor/pipeline.go - Poem processing → Repository queries and writes: writes poem batches
internal/processor/pipeline.go - Poem processing → Deduplication: finalizes poems
- Schema migration → Classification and conversion: uses classifiers
internal/database/migrate.go - Import command → Schema migration: prepares database
- HTTP server → Server configuration: loads settings
cmd/server/main.go - HTTP server → SQLite database: opens database
cmd/server/main.go - HTTP server → REST routing: sets up routes
cmd/server/main.go - REST routing → Request middleware: registers middleware
internal/api/rest/router.go - REST routing → Poem search and lists: routes poem requests
internal/api/rest/router.go - REST routing → Author endpoints: routes author requests
internal/api/rest/router.go - REST routing → Dynasty endpoints: routes dynasty requests
internal/api/rest/router.go - REST routing → Poetry type endpoints: routes type requests
internal/api/rest/router.go - REST routing → Health and statistics: routes health and stats
internal/api/rest/router.go - Poem search and lists → Repository queries and writes: queries poems
internal/api/rest/handler/poem.go - Author endpoints → Repository queries and writes: queries authors
internal/api/rest/handler/author.go - Dynasty endpoints → Repository queries and writes: queries dynasties
- Poetry type endpoints → Repository queries and writes: queries types
- Health and statistics → Repository queries and writes: reads statistics
- Repository queries and writes → SQLite database: reads and writes
internal/database/repository_write.go - API clients → REST routing: requests REST
README.md - HTTP server → GraphQL transport: registers GraphQL
cmd/server/main.go - GraphQL transport → GraphQL resolvers: dispatches queries
internal/graph/server.go - GraphQL resolvers → Resolver dependencies: uses dependencies
internal/graph/schema.resolvers.go - Resolver dependencies → Repository queries and writes: queries data
internal/graph/resolver.go - API clients → GraphQL transport: requests GraphQL
README.md