BSR POS Wiki

เว็บไซต์นี้เป็น wiki ภายในของ repository หลัก bsr-pos-plus ใช้เป็นแหล่งข้อมูลหลักสำหรับโครงสร้างระบบ ขั้นตอนงาน การตั้งค่าเครื่อง และข้อควรระวังด้าน deploy

ขอบเขต

• แอป Mobile POS ใน apps/mobile
• แอป POS Terminal ใน apps/pos-terminal
• shared packages ใน packages/*
• Android setup และ machine migration notes
• ขั้นตอนงานหลักของธุรกิจ เช่น การขาย การชำระเงิน และการใช้อุปกรณ์ต่อพ่วง

เริ่มจากตรงนี้

• ภาพรวมระบบ
• สถาปัตยกรรม mobile และ terminal
• ขั้นตอนตั้งแต่เปิดแอปของ Mobile และ Terminal
• แผนผังเมนูครบทุกเมนูของ Mobile และ Terminal
• ใบสั่งขาย
• POS หน้าร้าน
• ขั้นตอนงานการขาย
• ขั้นตอนงานรับสินค้าเข้าตรง
• ขั้นตอน login ไปเลือกสาขาและเข้า Home
• เมนู Home และสิทธิ์
• ขนส่งและยานพาหนะบน Mobile
• ตั้งค่า Android
• Checklist การย้ายเครื่อง
• กติกาการดูแล wiki
• บันทึกการเปลี่ยนแปลง

หลักการของเอกสาร

• วาง diagram ไว้ใกล้กับหน้าที่อธิบายมัน
• ใช้ Mermaid สำหรับ architecture และ ขั้นตอนงาน เพื่อให้ review ผ่าน Git ได้
• เอกสาร setup ควรเลี่ยงข้อมูลผูกกับเครื่องให้มากที่สุด
• ถ้ามีข้อยกเว้นเฉพาะ repo เช่น path, toolchain หรือ release step ที่ไม่เหมือนปกติ ให้บันทึกไว้ชัดเจน
• เมื่อ flow ของระบบในแอปเปลี่ยน ให้แก้ wiki หน้าที่เกี่ยวข้องในงานเดียวกันเป็นค่าเริ่มต้น