站點之間交換數據而不丟資訊,前提是每個欄位的含義與取值在各處一致。下面這些詞表是數據契約:改動要各節點同步。
多語言名稱
名稱按語言分別存放:{"zh_CN": "宮保雞丁", "en": "Kung Pao Chicken", "fr": "Poulet Kung Pao"}。語言代號:中文分 zh_CN 與 zh_TW,其他語言用兩位代號。顯示時按頁面語言取,缺了依次退到站點預設語言、簡體中文、任何有的一種。
菜品的分面
分類與呈現分開:一道菜在菜單上放在哪一欄由餐館定;它「是什麼」由下面這些互相獨立的面描述。
| 面 | 含義 | 取值 |
|---|---|---|
| 膳食角色 | 在一餐裡的位置 | 前菜、湯羹、主菜、主食、配菜、甜點、飲品、醬料(單值) |
| 主食材 | 以什麼為主 | 牛肉、禽肉、豬肉、羊肉、水產、蛋奶、豆制、蔬菜、菌菇、穀物(多值) |
| 菜系 | 區域之下分菜系 | 樹狀,可擴展(多值) |
| 烹法 | 多值 | |
| 溫度 | 上桌時的溫度 | 單值 |
| 辣度 | 0 到 5 的整數 | |
| 過敏原 | 歐盟十四類 | 每類三態,必須標註 |
| 膳食適宜、宗教與倫理、成分標誌 | 素食、清真等聲明;含酒精等客觀標誌 | 多值 |
| 營養 | 鍵值表 |
過敏原
按歐盟第 1169/2011 號條例附件二的十四類:含麩質穀物、甲殼類、蛋、魚、花生、大豆、奶、堅果、芹菜、芥末、芝麻、二氧化硫及亞硫酸鹽、羽扇豆、軟體動物。每一類取三態之一:含有、可能含有、不含。
關於過敏原。菜品庫裡的過敏原是參考標註。一道菜在某家餐館裡實際含什麼,取決於那家餐館的配方與當日備料,以餐館自己的聲明為準。詳見免責聲明。
食材與食養預標
食材類別是一張固定的詞表:蔬菜、水果、肉禽、水產、蛋類、豆製品、主食穀物、堅果、香辛料、調味品、飲品。每種食材另有三項食養傳統的預標:
| 維度 | 取值 | 基數 |
|---|---|---|
| 四氣 | 熱、溫、平、涼、寒 | 單值 |
| 五味 | 辛、甘、酸、苦、鹹 | 多值 |
| 五行 | 水、木、火、土、金 | 單值 |
食養預標是傳統分類的記錄,用於菜品搭配的參考,不是營養學結論,更不是醫療建議。
供應條目
種類三種:食材、用品、設備;各有自己的類別詞表(見供銷網路)。其餘欄位:多語言品名、品牌、規格、包裝、計量單位、價格與貨幣、起訂量、供貨期(天)。食材類條目用食材主庫的代號關聯到食材。
來源與版本
每條記錄帶來源(哪個節點、誰貢獻、何時更新)與版本號;每次修改版本號加一。匯入到餐館之後的數據歸餐館自己,之後與庫裡的記錄各自演變。