Skip to content
goragodwiriyaPublic

About

ระบบบัญชีออนไลน์ Online Accounting System (OAS)

Topics

Resources

Stars

60 stars

Watchers

13 watching

Forks

Repository files navigation

OAS

OAS (Online Accounting System) คือระบบหลังบ้านแบบเว็บสำหรับจัดการลูกค้า สินค้าคงคลัง และเอกสารซื้อขายในที่เดียว โดยโค้ดชุดนี้ใช้ PHP + Kotchasan/GCMS ฝั่งเซิร์ฟเวอร์ และ Now.js เป็น SPA frontend สำหรับหน้าใช้งานหลัก

รีโปนี้เหมาะกับการนำไปต่อยอดเป็นระบบบริหารงานขาย ระบบสต็อกสินค้า ระบบจัดซื้อ หรือระบบแอดมินภายในองค์กรที่ต้องการหน้าเว็บใช้งานจริงพร้อม API, export, ผู้ใช้หลายสิทธิ์ และเมนูตั้งค่าระบบ

จุดเด่นของระบบ

  • จัดการลูกค้าและซัพพลายเออร์ในโมดูล customer
  • จัดการสินค้า หมวดหมู่ สต็อก การเคลื่อนไหวสินค้า และต้นทุนในโมดูล inventory
  • จัดการเอกสารสำคัญในโมดูล order เช่น Quotation, Receipt, Purchase Order, Returned และ Goods Receipt
  • มีระบบสมาชิก สิทธิ์ผู้ใช้ ภาษา อีเมล API และการตั้งค่า LINE, Telegram, SMS
  • รองรับงาน export ผ่าน export.php
  • มี installer สำหรับติดตั้งระบบผ่านเว็บในโฟลเดอร์ install/
  • มี frontend bundle ที่ build มาแล้วใน Now/dist/ จึงสามารถติดตั้งเพื่อใช้งานได้ทันทีโดยไม่ต้อง build ใหม่ทุกครั้ง

Tech Stack

Layer รายละเอียด
Frontend Now.js SPA, route หลักอยู่ใน js/main.js
Backend PHP + Kotchasan + GCMS
Database MySQL / MariaDB ผ่าน PDO MySQL
Build tools Vite, npm scripts ใน package.json
Entry points index.html, api.php, export.php, line/webhook.php

โมดูลหลัก

modules/order

  • หน้า dashboard และรายการเอกสาร
  • สร้างและแก้ไขเอกสารซื้อขาย
  • จัดการช่องทางชำระเงินและวิธีจัดส่ง
  • รองรับประเภทเอกสาร QT, RCP, PO, RET, GR

modules/inventory

  • จัดการสินค้าและข้อมูลสินค้า
  • ดู stock movement และ cost layers
  • จัดการหมวดหมู่สินค้าและค่าตั้งต้นของโมดูล

modules/customer

  • จัดการข้อมูลลูกค้า
  • ใช้รูปแบบเดียวกันกับ supplier โดยอิงประเภทข้อมูลในระบบ

modules/index

  • ระบบ auth, profile, users, permissions
  • หน้าตั้งค่าทั่วไปของระบบ
  • ภาษา, email, API, theme, LINE, Telegram, SMS

ความต้องการของระบบ

  • PHP 7.4 ขึ้นไป
  • MySQL หรือ MariaDB
  • PHP extensions ที่ installer ตรวจจริง
    • PDO MySQL
    • mbstring
    • zlib
    • JSON
    • XML
    • OpenSSL
    • GD
    • cURL
  • สิทธิ์เขียนไฟล์/โฟลเดอร์สำหรับ
    • datas/
    • datas/cache/
    • datas/logs/
    • datas/images/
    • settings/
    • settings/config.php
    • settings/database.php
  • Node.js และ npm เฉพาะงานพัฒนา frontend (npm run dev)

ติดตั้งแบบย่อ

  1. คัดลอกโปรเจ็กต์ไปไว้ใน web root ของ Apache, Nginx หรือ local PHP stack
  2. ตรวจสอบสิทธิ์เขียนของโฟลเดอร์ datas/ และ settings/
  3. เปิดหน้า install/ ผ่านเบราว์เซอร์
  4. กรอกข้อมูลผู้ดูแลระบบและข้อมูลฐานข้อมูลตามขั้นตอนบนหน้าจอ
  5. เมื่อติดตั้งเสร็จ ให้ลบโฟลเดอร์ install/
  6. ปรับ DEBUG ใน load.php ให้เหมาะกับ production
  7. เข้าระบบแล้วตรวจสอบบัญชีตัวอย่างที่ installer สร้างไว้ และลบหรือปิดใช้งานหากไม่ต้องใช้

คำสั่งสำหรับพัฒนา

npm run dev

ไฟล์ใน Now/dist เป็นบันเดิลของ Now.js ที่ build มาแล้ว โปรเจ็คนี้ไม่ build Now.js เอง — Now.js แก้และ build ที่ adminframework แล้วกระจายมาพร้อม Now/

โครงสร้างสำคัญของโปรเจ็กต์

index.html          SPA shell หลัก
js/main.js          ตั้งค่า Now.js, auth, i18n และ router
api.php             จุดเข้า API หลัก
export.php          จุดเข้า export/print
install/            ระบบติดตั้งผ่านเว็บ
modules/order/      เอกสารซื้อขายและ dashboard
modules/inventory/  สินค้า สต็อก และต้นทุน
modules/customer/   ลูกค้าและซัพพลายเออร์
templates/          HTML templates ของหน้าใช้งาน
Now/                frontend framework และ build sources

Deployment Note

ระบบ frontend ใช้ router mode แบบ history ใน js/main.js ดังนั้นถ้า deploy บน Apache หรือ Nginx ควรตั้งค่า fallback ให้ route ฝั่งหน้าเว็บอย่าง /orders หรือ /inventory-products กลับมาเปิด index.html ได้ โดยไม่ไป rewrite asset files, api.php, export.php และ line/

Security Checklist หลังติดตั้ง

  • ลบโฟลเดอร์ install/
  • ปรับ DEBUG ใน load.php ให้ไม่แสดง error บน production
  • ตรวจสอบบัญชีตัวอย่างที่ installer เพิ่มให้อัตโนมัติ เช่น demo
  • ตั้งค่าอีเมลและ API secrets ให้ตรงกับสภาพแวดล้อมจริง
  • สำรองโฟลเดอร์ datas/ และไฟล์ใน settings/

License

โปรเจ็กต์นี้ใช้สัญญาอนุญาตแบบ MIT ดูรายละเอียดได้ที่ LICENSE

About

ระบบบัญชีออนไลน์ Online Accounting System (OAS)

Topics

Resources

Stars

60 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages