หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>ซอร์สโค้ดอื่น ๆ
ดาวน์โหลด
ผู้เชี่ยวชาญ Heroku
การทดสอบ
ความครอบคลุม

'สำรวจฉัน sa graphqql' [แอปพลิเคชันเซิร์ฟเวอร์]

โครงการนี้มีศูนย์กลางอยู่ที่การแยกวิเคราะห์ชุดข้อมูลต่าง ๆ รวมถึงข้อมูลรัฐบาลของสหราชอาณาจักรเกี่ยวกับการขายอสังหาริมทรัพย์ข้อมูลการรายงานของตำรวจและข้อมูลโพสต์รหัส เป้าหมายคือการควบคุมข้อมูลทางภูมิศาสตร์เพื่อสร้างการเชื่อมต่อระหว่างรหัสไปรษณีย์โดยใช้ละติจูดและลองจิจูด

วัตถุประสงค์หลักคือการพัฒนาแบ็กเอนด์ GraphQL ที่ปรับขนาดได้ซึ่งสามารถส่งมอบผลลัพธ์ที่ร้องขอได้อย่างรวดเร็ว ความพยายามนี้พยายามที่จะส่องสว่างด้านที่ซับซ้อนของการใช้ GraphQL การจัดการกับความท้าทายเช่นปัญหา N+1 และสถานการณ์การปรับขนาดซึ่งจำเป็นต้องใช้ฐานข้อมูลมากกว่าหนึ่งฐานข้อมูลสำหรับทั้งการเขียนและการอ่านโหนด

คุณสมบัติที่สำคัญของโครงการรวมถึงระบบการประกันคุณภาพอัตโนมัติที่แข็งแกร่ง (QA) ซึ่งรวมการเพาะข้อมูลข้อมูลที่ไม่ระบุชื่อสำหรับการทดสอบ QA ที่ครอบคลุม โครงการยังสำรวจความยืดหยุ่นของ JavaScript ผลักดันขอบเขตของภาษา โดยเฉพาะอย่างยิ่งมันเจาะลึกลงไปในข้อ จำกัด ของฟิลด์วัตถุ V8 เริ่มต้นซึ่งต่อยอดอยู่ที่ประมาณ ~ 8.4 ล้านในขณะที่เน้นความสามารถในการจัดการที่เหนือกว่าของโครงสร้างข้อมูลแผนที่

นอกจากนี้โครงการยังรวมระบบคิวเพื่อเพิ่มประสิทธิภาพของการประมวลผลข้อมูล ในสาระสำคัญโครงการทำหน้าที่เป็นการสาธิตเชิงปฏิบัติในแง่มุมที่หลากหลายและสูงของการพัฒนาซอฟต์แวร์สะท้อนให้เห็นถึงความมุ่งมั่นสู่ความเป็นเลิศและนวัตกรรม

  • GraphQL Live Demo [ไม่พร้อมใช้งานในปัจจุบัน]
  • ตัวอย่างเว็บแอปพลิเคชันของวิธีการใช้ข้อมูล
    • การสาธิตเว็บแอปพลิเคชัน [ไม่พร้อมใช้งานในปัจจุบัน]

ข้อกำหนดซอฟต์แวร์

หากคุณใช้คำสั่ง make , Docker และ Docker-compose และ local node.js กับ NPM เป็นทางเลือก

  • node.js v18+
  • NPM V5+ หรือเส้นด้าย
  • MakeFile เสริม ออกมาจากกล่องในสภาพแวดล้อม ของ Unix
  • นักเทียบ ท่า V18.09+
  • SQLITE3 V3+ สำหรับการทดสอบ 'การรวม' เท่านั้น

เทคโนโลยีที่ใช้แล้ว

  • เซิร์ฟเวอร์อพอลโล
  • Express.js
  • ทำด้วยความเห็น
  • Dataloader
  • graphql
  • ล้อเล่น

บริการที่ใช้แล้ว

  • Circle CI
  • Codecov
  • รหัสภูมิอากาศ
  • สไนค์

สถานที่รับชุดข้อมูล

  • รหัสไปรษณีย์ของสหราชอาณาจักร
  • ข้อมูลการขายบ้านในสหราชอาณาจักร
  • ข้อมูล UK LSOA และรหัสไปรษณีย์
  • บันทึกข้อมูลตำรวจ

วิธีการติดตั้ง

  • ด้วยคำสั่ง make ไม่จำเป็นต้องมีขั้นตอนเพิ่มเติมไม่เช่นนั้นคุณต้องดำเนินการ $ npm i

วิธีเรียกใช้การทดสอบ

  • $ make test หรือ $ npm test
    • Params CLI 'jest' เสริม ตัวอย่าง:
      • ในการรวบรวมความครอบคลุมตัวอย่าง: $ npm test -- --coverage รายงานจะอยู่ใน ./coverage directory
      • ในการดำเนินการทดสอบ เฉพาะ ในไฟล์เฉพาะตัวอย่างเช่น: $ npm test src/graphql/user.test.js

วิธีการตั้งค่าฐานข้อมูล

  • การกำหนดค่าฐานข้อมูลอยู่ในไฟล์ src/orm-config.js
  • ในการรับสคีมาฐานข้อมูลที่ทันสมัย: $ npm run sql db:migrate คุณยังสามารถสร้างฐานข้อมูลผ่าน ORM npm run sql db:create
  • เพื่อเพาะเมล็ดฐานข้อมูลด้วยข้อมูล 'ทดสอบ': $ npm run sql db:seed:all

วิธีเรียกใช้ในโหมด 'การพัฒนา'

  • $ make หรือ $ npm start

วิธีเรียกใช้ในโหมด 'การผลิต'

  • $ make serve ไม่มี NPM เทียบเท่า
  • หากคุณต้องการสร้างสินทรัพย์คงที่ เท่านั้น
    • $ make build หรือ $ npm run build - สินทรัพย์ที่สร้างขึ้นจะอยู่ใน ./ ไดเรกทอรี build

วิธีเรียกใช้คอนเทนเนอร์ที่มีตัวแปรต่าง ๆ โดยใช้ 'Make'

  • make PORT=18081

กล้ามเนื้อ

  • Heroku -> การผลิต ในปัจจุบันมี การเปลี่ยนแปลงเฉพาะการผลิต ทำให้เกิดการลดลงของการผลิต ทุกครั้ง
  • Master -> การผลิตที่ทันสมัยที่สุดพร้อม การร้องขอทั้งหมดในสาขานี้ได้รับการตรวจสอบบังคับ 'ci/circleci: jest'
  • สาขาคุณสมบัติ -> รับการรวมเข้ากับสาขาหลักเมื่อมีการตรวจสอบและการตรวจสอบบังคับผ่าน
  • CI ดำเนินการทดสอบในสภาพแวดล้อมที่แยกได้

ตัวแปรสภาพแวดล้อมที่ใช้แล้ว

ตัวแปร ค่าเริ่มต้น พิมพ์ คำอธิบาย
ท่าเรือ 8081 ตัวเลข พอร์ตที่แอปพลิเคชันจะพร้อมใช้งาน
ssl_key สาย เส้นทางที่แน่นอนไปยังคีย์ SSL (เช่น /home/ubuntu/private.key )
ssl_cert สาย เส้นทางที่แน่นอนไปยังใบรับรอง SSL (เช่น /home/ubuntu/certificate.crt )
- - - หากระบุการกำหนดค่าของแบบจำลองการเชื่อมต่อที่ไม่ใช่การจำลองจะใช้สำหรับการเขียนเท่านั้น
db_hostname 127.0.0.1 สาย โฮสต์ที่สามารถเข้าถึงฐานข้อมูลได้
db_username ราก สาย ชื่อผู้ใช้สำหรับการเชื่อมต่อกับฐานข้อมูล
db_password รหัสผ่าน สาย รหัสผ่านสำหรับผู้ใช้ฐานข้อมูล
db_port 3306 ตัวเลข พอร์ตที่สามารถเข้าถึงฐานข้อมูลได้
db_name สำรวจ สาย ชื่อของสคีมาฐานข้อมูล
db_dialect mysql สาย Database Dialect หนึ่งใน MySQL / SQLITE / Postgres
db_replica_hostname 127.0.0.1 สาย โฮสต์ของแบบจำลองฐานข้อมูลสำหรับการดำเนินการแบบอ่านอย่างเดียว
db_replica_username ราก สาย ชื่อผู้ใช้สำหรับการเชื่อมต่อกับแบบจำลองฐานข้อมูลสำหรับการดำเนินการแบบอ่านอย่างเดียว
db_replica_password รหัสผ่าน สาย รหัสผ่านสำหรับผู้ใช้ที่เชื่อมต่อกับแบบจำลองฐานข้อมูลสำหรับการดำเนินการแบบอ่านอย่างเดียว

ตัวประมวลผลข้อมูล

คำสั่ง npm ไฟล์ JS ที่เกี่ยวข้อง
parse:postcodes src/parse:postcodes
parse:postcodes:lsoa src/parse:postcodes:lsoa
parse:incidents src/parse:markers:and:incidents
parse:properties src/parse:markers:and:properties
parse:areas src/parse:areas
parse:timelines src/parse:timelines

ตัวอย่าง: npm run parse:postcodes -- --file=/media/data/postcodes.csv

ฐานข้อมูลที่รองรับ

ฐานข้อมูล รุ่น อะแดปเตอร์ วัตถุประสงค์หลัก
mysql 8 mysql2 การผลิต
PostgreSQL 11 หน้า การผลิต
sqlite 4 sqlite3 ระบบอัตโนมัติ QA & CI

  • หากคุณใช้ MySQL 5.7+ คุณต้องตรวจสอบให้แน่ใจ

  • PostrgesQl และ SQLite ได้รับการสนับสนุนบางส่วนเนื่องจากการสืบค้นบางส่วนไม่ได้เป็นเครื่องยนต์ที่ไม่เชื่อเรื่องพระเจ้าอย่างสมบูรณ์และฟังก์ชั่นบางอย่างไม่มีอยู่ใน SQLite เช่น

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด