街燈檔案的重要啟示
此模板為您提供了一個街燈燈杆檔案後端,包含燈杆記錄、燈泡型號跟蹤、鎮流器日誌和維護歷史,以便工作人員和協調員能夠使用同一真實資料來源。
- 以杆為先的記錄 — 為每個燈杆建模,包括位置、狀態、燈泡類型和鎮流器日誌指針,以便快速查詢。
- 燈泡型號可見性 — 將燈泡型號、功率和更換說明附加到檔案中,而不是埋在電子表格中。
- 鎮流器日誌歷史 — 儲存包含服務日期、技術員備註和後續行動的鎮流器日誌。
- 維護可追溯性 — 將維護歷史連結至一個電桿,以便於檢查、維修和更換保持易於審核。
- 移動和網頁存檔訪問 — 通過一個REST和GraphQL後端為電桿檔案提供現場工作組和辦公室人員服務。
概述:街燈電桿檔案
如果街燈檔案文件存放在收件箱中,您總是差一個錯過的附件而無法捍衛的發現。客戶在您承諾的預期到達時間中感受到這一點。此模板在Back4app上結構化電桿、燈泡類型、鎮流器日誌和維護條目,內建審核記錄,以便街燈檔案審查可以顯示可辯護的時間表。該架構涵蓋電桿(poleCode、locationName、poleType、status)、燈泡類型(name、technology、wattage、lifespanHours)、鎮流器日誌(pole、ballastModel、serviceDate、technicianNote)和維護條目(pole、actionType、performedAt、outcome),並內建身份驗證和檔案工作流程。連接您偏好的前端,保持電桿歷史組織有序。
最佳適用於:
您在街燈檔案模板中獲得的內容
良好的街燈檔案習慣看起來像是紀律:每次相同的字段、相同的生命週期語言,以及相同的審計追蹤。
首先檢查杆、燈泡類型和鎮流器記錄,然後打開堆疊卡片以查看 SDK 專用的筆記和集成模式。
核心街燈歸檔功能
此集線器中的每個技術卡片都使用相同的存檔模式,包括桿子、燈泡類型、壓舱物日誌和維護條目。
桿子登記
Pole class 儲存 poleCode、locationName、poleType、status 和 bulbType 指標。
燈泡類型目錄
BulbType 類別包含名稱、技術、瓦數和壽命小時。
壓舱物日誌追蹤
BallastLog 類別記錄桿子、壓舱物模型、服務日期及技術人員備註。
維護歷史
MaintenanceEntry 類別存儲桿子、操作類型、執行時間及結果。
為什麼要使用Back4app來構建您的街燈桿歸檔後端?
Back4app 提供桿歸檔原語——桿、燈泡類型、平衡器日誌和維護條目——讓您的團隊可以將時間花在檢查和歷史上,而不是寫後端代碼。
- •桿和燈泡跟踪: Pole 類型將 poleCode、locationName、bulbType 和 status 集中在一個地方。
- •維護和平衡器歷史: BallastLog 和 MaintenanceEntry 保存每根桿的服務日期、技術人員筆記和成果。
- •實時 + API 訪問: 使用 Live Queries 來獲取最新的維護更新,同時通過 REST 和 GraphQL 暴露相同的檔案。
透過一個後端合約構建實用的桿歸檔,可在移動端、網頁和現場工具中使用。
桿檔案的核心優勢
一個街燈存檔後端,方便查詢桿子詳情、燈具類型及服務歷史。
更快的桿查詢
通過 poleCode 或 locationName 搜索桿,而不是瀏覽無法連接的電子表格。
燈泡類型清晰度
將 BulbType 字段如技術和瓦數附加到每根桿上,讓工作人員知道他們正在維護什麼。
鎮流器日誌連續性
存儲帶有 serviceDate 和 technicianNote 的 BallastLog 項目,以便重複問題可見。
始終附加的歷史記錄
將 MaintenanceEntry 記錄鏈接到相同的桿上,以便檔案保持完整的服務追蹤。
方便現場數據訪問
對於需要相同桿檔案的檢查員、主管和辦公室協調員,使用一個 API。
AI啟動工作流程
從單一結構化提示生成檔案架構和整合計劃。
技術堆疊
這個街燈杆存檔後端模板中包含的所有內容。
燈桿 ER 圖
路燈燈桿 archive schema 的實體關係模型。
涵蓋燈桿、燈泡類型、鎮流器日誌和維護歷史的 schema。
查看圖表來源
erDiagram
Operator ||--o{ Pole : "assignedOperator"
Operator ||--o{ BulbRecord : "createdBy"
Operator ||--o{ BallastLog : "inspectedBy"
Operator ||--o{ MaintenanceEntry : "performedBy"
Pole ||--o{ BulbRecord : "pole"
Pole ||--o{ BallastLog : "pole"
Pole ||--o{ MaintenanceEntry : "pole"
Operator {
String objectId PK
String username
String email
String password
String role
Date createdAt
Date updatedAt
}
Pole {
String objectId PK
String poleNumber
String locationLabel
String bulbType
Date lastBallastCheckAt
String status
String assignedOperatorId FK
Date createdAt
Date updatedAt
}
BulbRecord {
String objectId PK
String poleId FK
String bulbType
Date installedAt
String notes
String createdById FK
Date createdAt
Date updatedAt
}
BallastLog {
String objectId PK
String poleId FK
Date inspectionDate
String ballastCondition
String actionTaken
String inspectedById FK
Date createdAt
Date updatedAt
}
MaintenanceEntry {
String objectId PK
String poleId FK
Date workDate
String taskType
String summary
Boolean resolved
String performedById FK
Date createdAt
Date updatedAt
}
歸檔整合流程
認證、杆查詢、燈泡類型更新、鎮流器日誌和維護歷史的典型運行流程。
查看圖表來源
sequenceDiagram
participant User
participant App as Streetlight Pole Archive App
participant Back4app as Back4app Cloud
User->>App: Sign in to review poles
App->>Back4app: POST /login
Back4app-->>App: Session token
User->>App: Open pole archive
App->>Back4app: GET /classes/Pole?include=assignedOperator
Back4app-->>App: Pole list with bulbType and status
User->>App: Add bulb record or ballast log
App->>Back4app: POST /classes/BulbRecord
App->>Back4app: POST /classes/BallastLog
Back4app-->>App: Saved record IDs
User->>App: Record maintenance history
App->>Back4app: POST /classes/MaintenanceEntry
Back4app-->>App: Maintenance entry saved
App->>Back4app: Subscribe to live updates for Pole and MaintenanceEntry
Back4app-->>App: Live query changes欄位字典
街燈歸檔架構中每個類別的完整欄位級參考。
| 欄位 | 類型 | 描述 | 必填 |
|---|---|---|---|
| objectId | String | Auto-generated unique identifier | 自動 |
| username | String | Login name for managers and field staff | |
| String | Work email address | ||
| password | String | Hashed password (write-only) | |
| role | String | Access role such as coordinator, inspector, or admin | |
| createdAt | Date | Auto-generated creation timestamp | 自動 |
| updatedAt | Date | Auto-generated last-update timestamp | 自動 |
7 欄位在 Operator 中
安全性和權限
ACL 和 CLP 策略如何保護電桿、燈泡類型、鎮流器日誌和維護歷史。
角色感知的存檔編輯
只有授權的協調者或技術人員可以創建或更改電桿、鎮流器日誌和維護條目的記錄。
歷史完整性
使用雲端代碼在將鎮流器和維護條目保存到電桿的存檔歷程之前進行驗證。
範圍讀取訪問
按地區、團隊或工作訂單限制檔案讀取,以便現場用戶僅查看所需的電線桿。
檔案架構 JSON
原始 JSON 架構定義,準備複製到 Back4app 或用作實施參考。
{
"classes": [
{
"className": "Operator",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"username": {
"type": "String",
"required": true
},
"email": {
"type": "String",
"required": true
},
"password": {
"type": "String",
"required": true
},
"role": {
"type": "String",
"required": true
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "Pole",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"poleNumber": {
"type": "String",
"required": true
},
"locationLabel": {
"type": "String",
"required": true
},
"bulbType": {
"type": "String",
"required": true
},
"lastBallastCheckAt": {
"type": "Date",
"required": false
},
"status": {
"type": "String",
"required": true
},
"assignedOperator": {
"type": "Pointer",
"required": true,
"targetClass": "Operator"
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "BulbRecord",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"pole": {
"type": "Pointer",
"required": true,
"targetClass": "Pole"
},
"bulbType": {
"type": "String",
"required": true
},
"installedAt": {
"type": "Date",
"required": true
},
"notes": {
"type": "String",
"required": false
},
"createdBy": {
"type": "Pointer",
"required": true,
"targetClass": "Operator"
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "BallastLog",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"pole": {
"type": "Pointer",
"required": true,
"targetClass": "Pole"
},
"inspectionDate": {
"type": "Date",
"required": true
},
"ballastCondition": {
"type": "String",
"required": true
},
"actionTaken": {
"type": "String",
"required": true
},
"inspectedBy": {
"type": "Pointer",
"required": true,
"targetClass": "Operator"
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "MaintenanceEntry",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"pole": {
"type": "Pointer",
"required": true,
"targetClass": "Pole"
},
"workDate": {
"type": "Date",
"required": true
},
"taskType": {
"type": "String",
"required": true
},
"summary": {
"type": "String",
"required": true
},
"resolved": {
"type": "Boolean",
"required": true
},
"performedBy": {
"type": "Pointer",
"required": true,
"targetClass": "Operator"
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
}
]
}使用 AI 代理建立
使用 Back4app AI 代理從此模板生成真正的路燈電線桿檔案應用,包括前端、後端、認證,以及電線桿、燈泡類型、鎮流器日誌和維護歷史流程。
在 Back4app 上創建一個街燈桿檔案應用後端,使用此確切的架構和行為。 架構: 1. 使用者(使用 Back4app 內建):用戶名,電子郵件,密碼;objectId,createdAt,updatedAt(系統)。 2. 桿子:poleCode(字串,必要),locationName(字串,必要),poleType(字串,必要),status(字串,必要),bulbType(指向 BulbType 的指標,可選),ballastLog(指向 BallastLog 的指標,可選);objectId,createdAt,updatedAt(系統)。 3. BulbType:name(字串,必要),technology(字串,必要),wattage(數字,必要),lifespanHours(數字,可選),notes(字串,可選);objectId,createdAt,updatedAt(系統)。 4. BallastLog:pole(指向 Pole 的指標,必要),ballastModel(字串,必要),serviceDate(日期,必要),technicianNote(字串,可選),replaced(布林值,必要);objectId,createdAt,updatedAt(系統)。 5. MaintenanceEntry:pole(指向 Pole 的指標,必要),actionType(字串,必要),performedAt(日期,必要),outcome(字串,必要),technicianName(字串,可選);objectId,createdAt,updatedAt(系統)。 安全性: - 只有授權用戶可以創建或更新桿檔案條目。使用 Cloud Code 來驗證桿歷史寫入。 授權: - 註冊,登入,登出。 行為: - 列出桿子,檢查燈泡類型詳細信息,添加鎮流器日誌並附加維護歷史。 交付: - 包含架構、ACL 和 CLP 的 Back4app 應用;桿子、燈泡類型、鎮流器日誌和維護歷史的前端。
按下方按鈕以使用此模板提示預填打開代理。
這是沒有技術後綴的基本提示。您可以在後續調整生成的前端堆疊。
API 遊樂場
對街燈檔案架構嘗試 REST 和 GraphQL 端點。響應使用模擬數據,無需 Back4app 帳戶。
使用與此模板相同的架構。
選擇您的技術
展開每個卡片以查看如何將 Pole、BulbType 和 BallastLog 整合到您選擇的技術堆棧中。
Flutter 路燈存檔後端
React 路燈存檔後端
React 原生 路燈存檔後端
Next.js 路燈存檔後端
JavaScript 路燈存檔後端
Android 路燈存檔後端
iOS 路燈存檔後端
Vue 路燈存檔後端
Angular 路燈存檔後端
GraphQL 路燈存檔後端
REST API 路燈存檔後端
PHP 路燈存檔後端
.NET 路燈存檔後端
每種技術為您提供的內容
每個堆棧都使用相同的路燈檔案架構和 API 合同。
統一的電杆檔案數據結構
使用一個一致的架構管理 Pole、BulbType、BallastLog 和 MaintenanceEntry。
現場團隊的燈泡類型查詢
當電杆被打開時顯示燈泡技術、功率和壽命小時。
鎮流器和維護歷史
保持服務記錄附在同一根柱子上,以便後續工作易於追蹤。
基於角色的檔案工作流程
使用權限和雲端代碼將協調員的操作與技術員的操作分開。
每個客戶的 REST/GraphQL 訪問
將儀表板、行動表單和報告工具連接到同一檔案後端。
街燈檔案框架比較
比較所有支援技術的設置速度、SDK 風格和 AI 支持。
| 框架 | 設置時間 | 歸檔好處 | SDK 類型 | AI 支持 |
|---|---|---|---|---|
| 大約 5 分鐘 | 用於現場和辦公室 Pole 歸檔應用的單一代碼庫。 | 類型化 SDK | 完整 | |
| 少於 5 分鐘 | 快速的網路儀表板,用於 Pole 庫存和日誌。 | 類型化 SDK | 完整 | |
| 約 3-7 分鐘 | 跨平台的移動應用程序,用於檢查和維護歷史記錄。 | 類型化 SDK | 完整 | |
| 快速(5分鐘)設置 | 為協調員提供的服務器渲染檔案門戶。 | 類型化SDK | 完整 | |
| 大約3–5分鐘 | 輕量級的網絡集成,用於杆查詢屏幕。 | 類型化SDK | 完整 | |
| 大約5分鐘 | 原生 Android 應用程序,供外勤人員使用。 | 類型化SDK | 完整 | |
| 少於5分鐘 | 原生iOS應用程序,用於檢查和服務備註。 | 已輸入的SDK | 完整 | |
| 約3–7分鐘 | React的網頁UI,用於存檔瀏覽。 | 已輸入的SDK | 完整 | |
| 快速(5分鐘)設置 | 企業操作控制台,用於杆管理。 | 已輸入的SDK | 完整 | |
| 少於2分鐘 | 靈活的 GraphQL API 用於嵌套檔案查詢。 | GraphQL API | 完整 | |
| 快速 (2 分鐘) 設定 | REST API 整合服務工具和儀表板。 | REST API | 完整 | |
| ~3 分鐘 | 伺服器端 PHP 後端用於檔案門戶。 | REST API | 完整 | |
| ~3–7 分鐘 | .NET 後端操作系統。 | 類型化 SDK | 完整 |
設置時間反映從項目啟動到使用此模板架構進行第一次 Pole 或 MaintenanceEntry 查詢的預期持續時間。
常見問題
有關使用此模板構建街燈電杆檔案後端的常見問題。