admin/pos-system
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(docs): Update Mermaid diagrams in Vietnamese guides for improved clarity and visual appeal

Browse Source 
- Enhanced Mermaid diagrams in the troubleshooting and workflow sections with clearer labels and emoji for better readability.
- Standardized the formatting of flowchart elements to ensure consistency across documentation.
- Improved the overall visual representation to align with recent updates in the English version.
This commit is contained in:
Ho Ngoc Hai
2026-01-10 17:02:20 +07:00
parent a7397b1065
commit be99b99dd3
2 changed files with 37 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/vi/guides/mermaid.md
View File

@@ -746,11 +746,11 @@ Sử dụng emoji để tăng khả năng đọc:
```mermaid
flowchart TD
Start([ Bắt đầu]) --> Auth{ Xác thực?}
Auth -->|| Error[Lỗi]
Auth -->|| Process[ Xử lý]
Process --> DB[( Database)]
DB --> Success[ Thành công]
Start(["🚀 Bắt đầu"]) --> Auth{"🔐 Xác thực?"}
Auth -->|"Không"| Error["❌ Lỗi"]
Auth -->|"Có"| Process["⚙️ Xử lý"]
Process --> DB[("💾 Database")]
DB --> Success["✅ Thành công"]
style Start fill:#2C3E50,color:#ECF0F1,stroke:#34495E,stroke-width:3px
style Success fill:#27AE60,color:#ECF0F1,stroke:#229954,stroke-width:2px

64
docs/vi/guides/troubleshooting.md
View File

@@ -46,56 +46,56 @@ Khi có sự cố, hãy làm theo danh sách kiểm tra sau:
```mermaid
flowchart TD
Start([ Phát Hiện Sự Cố]) --> CheckStatus{Kiểm tra<br/>Trạng thái Service}
Start(["Phát Hiện Sự Cố"]) --> CheckStatus{"Kiểm tra<br/>Trạng thái Service"}
CheckStatus -->|Tất cả Running| CheckLogs[ Xem Logs]
CheckStatus -->|Một số Down| IdentifyService[ Xác định Service<br/>Bị Lỗi]
CheckStatus -->|"Tất cả Running"| CheckLogs["Xem Logs"]
CheckStatus -->|"Một số Down"| IdentifyService["Xác định Service<br/>Bị Lỗi"]
IdentifyService --> ServiceType{Loại Service?}
IdentifyService --> ServiceType{"Loại Service?"}
ServiceType -->|Infrastructure| InfraCheck[ Kiểm tra<br/>Infrastructure]
ServiceType -->|Application| AppCheck[ Kiểm tra<br/>Application]
ServiceType -->|"Infrastructure"| InfraCheck["Kiểm tra<br/>Infrastructure"]
ServiceType -->|"Application"| AppCheck["Kiểm tra<br/>Application"]
InfraCheck --> DBCheck{Database?}
InfraCheck --> RedisCheck{Redis?}
InfraCheck --> TraefikCheck{Traefik?}
InfraCheck --> DBCheck{"Database?"}
InfraCheck --> RedisCheck{"Redis?"}
InfraCheck --> TraefikCheck{"Traefik?"}
DBCheck -->|Có| DBSolution[ Kiểm tra DATABASE_URL<br/> Verify kết nối Neon<br/> Kiểm tra IP whitelist]
RedisCheck -->|Có| RedisSolution[ Restart Redis<br/> Kiểm tra port mapping<br/> Verify connection string]
TraefikCheck -->|Có| TraefikSolution[ Kiểm tra labels<br/> Verify PathPrefix<br/> Kiểm tra health status]
DBCheck -->|"Có"| DBSolution["Kiểm tra DATABASE_URL<br/>Verify kết nối Neon<br/>Kiểm tra IP whitelist"]
RedisCheck -->|"Có"| RedisSolution["Restart Redis<br/>Kiểm tra port mapping<br/>Verify connection string"]
TraefikCheck -->|"Có"| TraefikSolution["Kiểm tra labels<br/>Verify PathPrefix<br/>Kiểm tra health status"]
AppCheck --> ErrorType{Loại Lỗi?}
AppCheck --> ErrorType{"Loại Lỗi?"}
ErrorType -->|Config| ConfigFix[ Kiểm tra .env variables<br/> Chạy init-project.sh]
ErrorType -->|Prisma| PrismaFix[ Kiểm tra migrations<br/> Regenerate client<br/> Reset database]
ErrorType -->|Auth| AuthFix[ Kiểm tra token expiry<br/> Verify keys<br/> Sync thời gian Docker]
ErrorType -->|"Config"| ConfigFix["Kiểm tra .env variables<br/>Chạy init-project.sh"]
ErrorType -->|"Prisma"| PrismaFix["Kiểm tra migrations<br/>Regenerate client<br/>Reset database"]
ErrorType -->|"Auth"| AuthFix["Kiểm tra token expiry<br/>Verify keys<br/>Sync thời gian Docker"]
CheckLogs --> LogAnalysis{Log Hiện<br/>Lỗi?}
LogAnalysis -->|Có| ErrorType
LogAnalysis -->|Không| ConnCheck[ Kiểm tra Kết nối]
CheckLogs --> LogAnalysis{"Log Hiện<br/>Lỗi?"}
LogAnalysis -->|"Có"| ErrorType
LogAnalysis -->|"Không"| ConnCheck["Kiểm tra Kết nối"]
ConnCheck --> GatewayTest{Gateway<br/>Truy Cập Được?}
GatewayTest -->|Không| TraefikCheck
GatewayTest -->|Có| ServiceTest{Service<br/>Truy Cập Được?}
ConnCheck --> GatewayTest{"Gateway<br/>Truy Cập Được?"}
GatewayTest -->|"Không"| TraefikCheck
GatewayTest -->|"Có"| ServiceTest{"Service<br/>Truy Cập Được?"}
ServiceTest -->|Không| AppCheck
ServiceTest -->|Có| Resolved([ Đã Giải Quyết])
ServiceTest -->|"Không"| AppCheck
ServiceTest -->|"Có"| Resolved(["Đã Giải Quyết"])
DBSolution --> Restart[ Restart Services]
DBSolution --> Restart["Restart Services"]
RedisSolution --> Restart
TraefikSolution --> Restart
ConfigFix --> Restart
PrismaFix --> Restart
AuthFix --> Restart
Restart --> Verify{Đã Sửa<br/>Xong?}
Verify -->|Có| Resolved
Verify -->|Không| DeepDebug[ Debug Sâu<br/>Hơn]
Restart --> Verify{"Đã Sửa<br/>Xong?"}
Verify -->|"Có"| Resolved
Verify -->|"Không"| DeepDebug["Debug Sâu<br/>Hơn"]
DeepDebug --> ContainerShell[Truy cập Container Shell]
DeepDebug --> PrismaStudio[Dùng Prisma Studio]
DeepDebug --> RedisInspect[Kiểm tra Redis]
DeepDebug --> APITest[Test API Trực tiếp]
DeepDebug --> ContainerShell["Truy cập Container Shell"]
DeepDebug --> PrismaStudio["Dùng Prisma Studio"]
DeepDebug --> RedisInspect["Kiểm tra Redis"]
DeepDebug --> APITest["Test API Trực tiếp"]
style Start fill:#1a1a2e,color:#fff
style Resolved fill:#0f3460,color:#fff