docs(sdlc): reformat work products to audited reference layout

Replace the PHP/Markdown seeding with a data-driven generator in
scripts/sdlc-seed and regenerate all 59 work products.
This commit is contained in:
Thanakorn
2026-09-09 08:09:54 +07:00
parent 758922f5c4
commit 087e7b3958
209 changed files with 8063 additions and 5762 deletions
@@ -0,0 +1,68 @@
# Project Repository
<!-- footer: PjR -->
| Document No | Project Repository | Release, Version, By: | 25690817 V1.0 ThS |
| Project Name | โครงการพัฒนาระบบบริหารจัดการคลังสินค้า (BRN WMS) บริษัท บี.อาร์.เอ็น เอ็นเตอร์ไพรส์ จำกัด |
| Project Code | 200-WMS-26-001-00 |
| Title | พื้นที่เก็บข้อมูล เอกสาร และหลักฐานทุกอย่างของโครงการ |
| ระยะเวลา | 5 มกราคม 2569 – 24 สิงหาคม 2569 |
| Organizer | คุณอภิรัชช์ สุภัทรประทีป (Project Manager) |
| Recorder | คุณเยาวลักษณ์ บางชมภู (Document Control) |
## ข้อมูล Repository
| หัวข้อ | รายละเอียด |
| --- | --- |
| ประเภท | Git Server |
| Repository หลัก (origin) | `git@188.166.228.62:nok/wms-app.git` |
| Branch หลัก | `main` |
| Branch เอกสารส่งมอบ | `sdlc` |
| Baseline ของระบบที่ส่งมอบ | Commit `6c39700` |
| Tag ของชุดเอกสารส่งมอบ | `sdlc-v1.0-final` |
| สิทธิ์การเข้าถึง | ยืนยันตัวตนด้วย SSH Key ตามบทบาทของสมาชิกโครงการ |
## โครงสร้างการจัดเก็บ
| ลำดับ | ส่วนงาน | ที่จัดเก็บ | เนื้อหา |
| :---: | --- | --- | --- |
| 1 | Source Code แอปพลิเคชัน | `app/` | เข้าสู่ระบบ, คลังสินค้า, ขาย, จัดซื้อ, การเงิน, บัญชี, รายงาน, บาร์โค้ด |
| 2 | บริการ Real-time และงานตามกำหนดเวลา | `nodejs/` | Socket.IO และงานสรุปยอด/แจ้งเตือน |
| 3 | การติดตั้งและตั้งค่า | `docker/`, `docker-compose.yml`, `setup.php`, `.env.example` | ชุดติดตั้ง Container และสคริปต์สร้างฐานข้อมูล |
| 4 | ข้อมูลสาธิต | `demo_seed*.php` | ชุดข้อมูลตัวอย่างสำหรับตรวจรับและสาธิต |
| 5 | เอกสาร Work Products | `sdlc/` | เอกสาร ISO/IEC 29110 กระบวนการ PM และ SI |
| 6 | ชุดเอกสารส่งมอบ | `sdlc-delivery/` | ไฟล์ PDF ที่สร้างจาก `sdlc/` |
| 7 | สคริปต์สนับสนุนโครงการ | `scripts/` | สคริปต์สร้างและตรวจสอบชุดเอกสารส่งมอบ |
## การควบคุมการเข้าถึงและการจัดเก็บ
- สมาชิกโครงการทุกคนเข้าถึง Repository ได้ผ่าน Git Server ตามสิทธิ์ของบทบาท
- Project Manager และ System Analyst มีสิทธิ์อนุมัติการ Merge เข้าสู่ Branch หลัก
- ไฟล์ที่เกี่ยวข้องกับโครงการทั้งหมดต้องจัดเก็บใน Repository นี้
- ค่าตั้งค่าและความลับของสภาพแวดล้อมต้องไม่ถูกนำเข้า Repository
## หลักฐานการจัดเก็บ
| ลำดับ | หลักฐาน | รายละเอียด |
| :---: | --- | --- |
| 1 | โครงสร้าง Repository และประวัติการเปลี่ยนแปลง | ตรวจสอบได้จาก Git Server ตามสิทธิ์ที่ได้รับ |
| 2 | Baseline ของระบบที่ส่งมอบ | Commit `6c39700` บน branch `main` |
| 3 | ชุดเอกสารส่งมอบที่ควบคุมแล้ว | Branch `sdlc` และ Tag `sdlc-v1.0-final` |
## ผู้จัดทำเอกสาร (Secretary)
| ชื่อ | ตำแหน่ง | ลายเซ็น | วันที่ |
| --- | --- | --- | --- |
| คุณธนกร สถิตวิทยากุล | Developer | | |
## ผู้ตรวจสอบเอกสาร (Reviewer)
| ชื่อ | ตำแหน่ง | ลายเซ็น | วันที่ |
| --- | --- | --- | --- |
| คุณอภิรัชช์ สุภัทรประทีป | Project Manager | | |
## ผู้อนุมัติ (Approval)
| ชื่อ | ตำแหน่ง | ลายเซ็น | วันที่ |
| --- | --- | --- | --- |
| คุณเสรี วิริยะสกุลธรณ์ | Project Sponsor | | |
@@ -1,73 +0,0 @@
# Project Repository
| Document field | Value |
|---|---|
| Document | Project Repository |
| Project | BRN WMS |
| Project code | 200-WMS-26-001-00 |
| Title | Master Project Repository Record |
| Project period | 05/01/26–24/08/26 |
| Release | 17/08/26 V1.0 |
| Standard | ISO/IEC 29110 Basic Profile |
| System Analyst | Noppong Chareunsook |
| Developer | Thanakorn Sathitwitayakul |
| Project Manager | Apirach Supattaratpateep |
| Project Sponsor / Customer Representative | Seri Viriyasakultorn |
| Status | Final |
## 1. Purpose
This record identifies the single authoritative repository that stores BRN WMS source code, deployment configuration, and SDLC work products, so that project artifacts can be located, accessed, and audited.
## 2. Repository identification
| Field | Value |
|---|---|
| Repository type | Git |
| Primary (authoritative) remote | `origin` — `git@188.166.228.62:nok/wms-app.git` |
| Default branch | `main` |
| Documentation delivery branch | `sdlc` |
| Delivered software baseline | `6c39700` on `main` |
| Access | SSH key-based Git authentication |
## 3. Repository contents
| Area | Path | Contents |
|---|---|---|
| Application source | `app/` | PHP application: login/onboarding, inventory/warehouse, orders, accounting, reporting, barcode |
| Realtime/scheduled services | `nodejs/` | Socket.IO notifications and scheduled stock/GL jobs |
| Deployment | `docker/`, `docker-compose.yml`, `.env.example`, `setup.php` | Container build, environment generation, one-shot database setup |
| Demo/seed data | `demo_seed*.php` | Representative demo data population scripts |
| SDLC work products | `sdlc/` | ISO/IEC 29110 PM and SI work products (this document's own folder) |
| SDLC delivery package | `sdlc-delivery/` | PDFs generated from `sdlc/` by `scripts/build-sdlc-delivery.sh` |
| Supporting scripts | `scripts/` | Project support scripts |
| Landing/front pages | `landing/` | Public-facing pages |
## 4. Repository management
The repository is managed solely through Git; there is no separate document-management system for source code. The delivered application baseline is commit `6c39700` on `main`. SDLC work-product Markdown is controlled in the same repository under `sdlc/` on the documentation delivery branch `sdlc`. The PDF delivery package is generated in-repo at `sdlc-delivery/` from those sources by `scripts/build-sdlc-delivery.sh`, mirroring the `sdlc/` folder structure.
## 5. Approval
### Prepared by
Name: Thanakorn Sathitwitayakul
Role: Developer
Signature: ______________________________________________
Date: ___________________________________________________
### Reviewed by
Name: Apirach Supattaratpateep
Role: Project Manager
Signature: ______________________________________________
Date: ___________________________________________________
### Reviewed and authorized by
Name: Seri Viriyasakultorn
Project roles: Project Sponsor / Customer Representative / Authorized Approver
Position: Managing Director
Company: B.R.N. Enterprise Co., Ltd.
Signature: ______________________________________________
Date: ___________________________________________________