wangxuming/XQKqueue
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: establish integrated project memory

Browse Source
This commit is contained in:
brother7
2026-08-12 19:33:12 +08:00
parent 50ac5bddc4
commit 1eb36645e4
31 changed files with 872 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
.project-docs/40-domain/glossary.md Normal file
View File

@@ -0,0 +1,15 @@
# Glossary
| Term | Meaning | Notes |
|---|---|---|
| Project | A queueable scenic-area service/attraction with its own code, configuration, status, and sessions | Public display URLs normally use the project code |
| Queue session | A project's operational queue for one business date | Owns next number and revision |
| Queue ticket | One numbered party waiting for or receiving service | Party size is immutable after creation |
| Call batch | One staff call action containing a contiguous set of tickets | Android announces first-to-last for a multi-ticket batch |
| Overview display | Multi-project public display corresponding to `/admin/display` | Read-only and never announces |
| Project display | One project's public display at `/display/{identifier}` | The only Android state allowed to announce |
| Snapshot | Authoritative privacy-safe project display response | Drives both Android UI and announcement detection |
| Display identifier | Project code or compatible public display token accepted by the snapshot endpoint | Overview navigation requires a non-empty project code |
| Revision | Monotonic queue-session change marker | Supports event/poll recovery and freshness |
| Experienced people | Displayed as the greater of the configured starting value and cumulative issued party size in the current project-local business-day session | Distinct from issued ticket count |
| Announcement baseline | First snapshot accepted after entering/resuming a project screen | Stored silently to prevent replaying an old call |