tiennm99
e8b76cc643
Load the whole dictionary into maps at Open and close the database before Open returns. The plan called for per-lookup SQLite, but a round-trip benchmarked at 55us against 8.9ns for a map hit, and the hard bot in a later phase explores hundreds of candidates inside a 150ms budget. The in-memory form is also simpler: no connection pool, no prepared statements, no tail latency. Costs ~70ms and ~7.8MB at startup. Resolve returns the canonical word, never the spelling the player typed. Canonicalization moves either end: about half the aliases differ in the last syllable and more than a third in the first, so "sy hai" resolves to "si hai". FirstSyllable and LastSyllable report the canonical's ends, and the engine must chain on those or it will reject legal moves. WordsStartingWith yields an iterator rather than the backing slice. A caller could otherwise sort, shuffle or append into dictionary state: verified that a write landed in the store, that most buckets have spare capacity for append to scribble into, and that concurrent callers race. Open validates what it loaded against the builder's recorded word count, cross-checks every out-degree against the words actually indexed, and rejects orphan aliases. A truncated database otherwise opens cleanly and the server starts, rejects every word, and fails every room creation. RandomOpeningWord picks from a pre-sorted slice by binary search instead of rebuilding a filtered copy per call, cutting room creation from 374us and 720KB to 18ns and no allocation. Escape the database path when building the URI: SQLite reads # as a fragment delimiter, so an unescaped path opens a different file and reports a misleading schema error. The store does not log. A library writing to the global logger fights structured logging later, and the caller has WordCount, AliasCount and License to state the CC BY-SA attribution itself.
noitu
Trò chơi nối từ tiếng Việt trên web — chơi với máy hoặc đấu 1v1 trực tuyến.
A web implementation of the Vietnamese word-chain game nối từ: each player submits a meaningful word of at least 2 syllables whose first syllable matches the last syllable of the previous word. No word may be reused. Fail to answer in time and you lose.
ngôn ngữ → ngữ pháp → pháp luật → luật lệ → ...
Status
In development. See plans/260904-1125-noi-tu-web-game/plan.md
for the implementation plan and phase breakdown.
Architecture
The server is authoritative: the browser never holds the wordlist, so word validation cannot be bypassed, and the bot and player-vs-player paths share one rule implementation.
SvelteKit SPA ──WebSocket + Protobuf──► Go server ──► SQLite dictionary
| Component | Choice |
|---|---|
| Frontend | SvelteKit 2 / Svelte 5 (JavaScript), adapter-static |
| Transport | WebSocket, Protobuf binary frames (@bufbuild/protobuf ↔ protoc-gen-go) |
| Backend | Go, coder/websocket |
| Dictionary | SQLite via modernc.org/sqlite (CGo-free), read-only at runtime |
Setup
Requires Go 1.25+, Node 20+, and optionally make.
make fetch-dict # one-time: downloads the ~179 MB upstream dictionary into data/
make dict # derives data/noitu.db (the game's wordlist) from it
make test # run all tests
make run # build and start the server
make fetch-dict is a one-time cost per machine. Neither database file is committed;
both are build artifacts. See data/ATTRIBUTION.md.
Make targets
| Target | Does |
|---|---|
fetch-dict |
Download the upstream dictionary.db (~179 MB) into data/ |
dict |
Derive data/noitu.db from the upstream database |
server |
Build the Go server binary |
web |
Build the SvelteKit frontend to static assets |
test |
Run Go and JavaScript tests |
run |
Build and run the server locally |
verify-dict |
Re-check the downloaded dictionary against its pinned SHA-256 |
Without make
make is not installed everywhere (notably Windows). Every target is a thin wrapper:
# fetch-dict
curl -L -C - -o data/dictionary.db https://github.com/minhqnd/dictionary/releases/download/v2.0.0/dictionary.db
# dict
cd server && go run ./cmd/build-dictionary --in ../data/dictionary.db --out ../data/noitu.db
# test
cd server && go vet ./... && go test ./... -race
# server
cd server && CGO_ENABLED=0 go build -o ../noitu-server ./cmd/noitu-server
License
This project is distributed under two licenses, applying to different artifacts.
See NOTICE for the full statement.
| Artifact | License |
|---|---|
All source code (server/, web/, proto/) |
Apache-2.0 |
Dictionary data (data/noitu.db) |
CC BY-SA 4.0 |
The dictionary is derived from minhqnd/dictionary
(data licensed CC BY-SA 4.0), which itself aggregates Wiktionary and other Vietnamese
dictionary sources. CC BY-SA is a share-alike license: any redistribution of the derived
database — including inside a container image — must carry the same license, the attribution,
and the record of modifications recorded in data/ATTRIBUTION.md.
The database is loaded at runtime from a file and is never embedded or linked into the Go binary, keeping the two licensing regimes on separate artifacts.