theyworkforyou
1.0.0
สวัสดีทุกคน,
นี่คือซอร์สโค้ดที่ขับเคลื่อนเว็บไซต์ TheyWorkForYou.com ส่วนใหญ่เขียนด้วย PHP แม้ว่าจะมีสคริปต์ Perl บางตัวสำหรับการโหลดและจัดทำดัชนีฐานข้อมูลก็ตาม รหัสตัวแยกวิเคราะห์แบ็กเอนด์แยกจากกันและมีอยู่ใน GitHub คุณสามารถอ่านเพิ่มเติมเกี่ยวกับสิ่งนี้ได้ที่หน้าข้อมูล parser ของ TheyWorkForYou
ซอร์สโค้ด TheyWorkForYou ในการแจกจ่ายนี้เผยแพร่ภายใต้สิทธิ์การใช้งานแบบ BSD โดยคร่าวๆ หมายความว่าคุณสามารถคัดลอก ใช้ แก้ไข และแจกจ่ายโค้ดหรือไบนารีที่สร้างจากโค้ดอีกครั้งได้ อนุญาตให้ใช้ในเชิงพาณิชย์หรือไม่ใช่เชิงพาณิชย์ อย่างไรก็ตาม เราปฏิเสธการรับประกัน และหวังว่าคุณจะไม่ใช้ชื่อของเราโดยไม่ได้รับอนุญาตจากเรา ดูไฟล์ LICENSE.md สำหรับข้อมูลทางกฎหมายที่แน่นอน
ทุกสิ่งที่สมาชิกสภาผู้แทนราษฎรพูดในสภาแห่งสหราชอาณาจักรจะถูกบันทึกไว้ในเอกสารชื่อ Hansard; TheyWorkForYou ช่วยทำความเข้าใจทรัพยากรประชาธิปไตยที่สำคัญนี้ นอกจากนี้ยังรวมถึงสิ่งต่างๆ จากสภาขุนนาง รัฐสภาสกอตแลนด์ และสภาไอร์แลนด์เหนือ
ดู INSTALL.md สำหรับคำถามในการติดตั้ง
หากคุณมีคำถาม สถานที่ที่ดีที่สุดที่จะถามคือรายชื่ออีเมล mySociety TheyWorkForYou ที่ https://groups.google.com/a/mysociety.org/forum/#!forum/theyworkforyou
คุณจะต้องใช้ Docker เวอร์ชันล่าสุด
การรัน docker compose up [ -d ] จะเริ่มต้นสภาพแวดล้อม ครั้งแรกที่คุณเรียกใช้อาจใช้เวลาสักครู่เมื่อมีการดาวน์โหลดรูปภาพต่างๆ และอิมเมจแอปพลิเคชันที่สร้างขึ้นในเครื่อง
เมื่อเสร็จแล้วคุณควรจะสามารถดูหน้าแรกได้ที่ http://localhost:8000 อย่างไรก็ตาม โครงสร้างเริ่มต้นไม่มีข้อมูล ดังนั้นโปรดดูที่ INSTALL.md เพื่อดูข้อมูลเกี่ยวกับการดาวน์โหลดและการนำเข้าข้อมูล Parlparse (สมาชิก การอภิปราย การโหวต ฯลฯ)
คุณสามารถหยุดสภาพแวดล้อมได้ด้วยการเรียกใช้ docker compose down การเพิ่ม -v จะลบโวลุ่ม Docker ที่อาจใช้งานอยู่ รวมถึงข้อมูลทั้งหมดด้วย
DOCKER.md มีหมายเหตุโดยละเอียดเพิ่มเติมเกี่ยวกับสภาพแวดล้อมการพัฒนา พร้อมด้วยคำสั่งที่มีประโยชน์และบันทึกการตั้งค่าเฉพาะ Docker ที่มีรายละเอียดเพิ่มเติม
หากต้องการใช้ xdebug ใน VS Code ในขณะที่ใช้ WSL คุณจะต้องตั้งค่าตัวแปรสภาพแวดล้อมของ WSL_IP ภายในระบบย่อยของที่อยู่ IP ของระบบย่อย
เริ่มโค้ดสเปซใหม่บน Github โดยเลือกดรอปดาวน์โค้ด (ขวาบน) และเริ่มโค้ดสเปซใหม่ (หรือใช้ GitHub CLI)
คุณยังใช้ป้ายด้านบนเพื่อใช้การสร้างล่วงหน้าด้วยข้อมูลพื้นฐานได้อีกด้วย
นี่จะเป็นการตั้งค่าคอนเทนเนอร์ Docker และสภาพแวดล้อม เมื่อเสร็จแล้ว ลิงก์ไปยังไซต์ควรจะพร้อมใช้งานในแท็บพอร์ตของแผงเทอร์มินัล
หากต้องการเติมข้อมูลให้น้อยที่สุด ให้รัน scripts/quick-populate (ประมาณ 1 ชั่วโมง)
หากคุณกำลังทำงานในเพจที่ใช้การออกแบบใหม่ คุณจะต้องรวบรวมเนื้อหาคงที่หลังการเปลี่ยนแปลง:
script/watch-cssหรือ
cd www/docs/stylebundle exec compass compile สำหรับการรวบรวมครั้งเดียวหรือ bundle exec compass watch เพื่อคอมไพล์ใหม่เมื่อมีการเปลี่ยนแปลง script/lint จะรัน php-cs-fixer สำหรับไฟล์ php
TheyWorkForYou มีชุดทดสอบโดยใช้ PHPunit หากต้องการรันการทดสอบ ตรวจสอบให้แน่ใจว่าตัวแปรสภาพแวดล้อม TWFY_TEST_DB_HOST , TWFY_TEST_DB_NAME , TWFY_TEST_DB_USER และ TWFY_TEST_DB_PASS ได้รับการตั้งค่าและมีข้อมูลที่เกี่ยวข้องสำหรับฐานข้อมูลการทดสอบของคุณ ฐานข้อมูลจะถูกรื้อออกและสร้างใหม่ในระหว่างการทดสอบ ดังนั้นโปรดตรวจสอบให้แน่ใจว่าไม่ใช่สำเนาที่สำคัญ
คุณอาจพบว่ามีข้อผิดพลาด PHPUnit บางเวอร์ชันเกิดขึ้นเกี่ยวกับรายงานการครอบคลุมโค้ด ในกรณีนี้ เวอร์ชันที่ติดตั้งโดย Composer และอยู่ที่ /vendor/bin/phpunit ควรทำงานอย่างถูกต้อง
ขอขอบคุณ Browserstack ที่ให้เราใช้เครื่องมือทดสอบข้ามเบราว์เซอร์บนเว็บสำหรับโปรเจ็กต์นี้
