BSR POS Wiki

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

ขอบเขต

• แอป Mobile POS ใน apps/mobile
• แอป POS Terminal ใน apps/pos-terminal
• shared packages ใน packages/*
• Android setup และ machine migration notes
• workflow หลักของธุรกิจ เช่น sales, checkout และ peripheral interactions

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

• ภาพรวมระบบ
• สถาปัตยกรรม mobile และ terminal
• workflow การขาย
• workflow รับสินค้าเข้าตรง
• workflow login ไป branch ไป home
• Home menu และ permissions
• Mobile transport และ vehicles
• Android setup
• Machine migration checklist
• กติกาการดูแล wiki
• change log

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

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