KnowCall Application

แอปพลิเคชันป้องกันการโทรหลอกลวงและสแปมสำหรับผู้ใช้ไทย

📚 เอกสาร (Documentation)

• Wiki - คู่มือการใช้งานแบบละเอียด
• Getting Started - เริ่มต้นใช้งาน
• Phone Verification - วิธีตรวจสอบหมายเลข
• FAQ - คำถามที่พบบ่อย
• Safety Tips - เคล็ดลับความปลอดภัย
• API Documentation - เอกสาร API
• Architecture - สถาปัตยกรรมระบบ
• Setup Guide - คู่มือการติดตั้ง

แนวคิด (Concept)

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

คุณสมบัติสำคัญ (Features)

🛡️ การป้องกันสายเรียกเข้า

• บล็อกเลขที่ซ่อน: บล็อกสายโทรศัพท์จากหมายเลขที่ซ่อนหรือหมายเลขที่ไม่ได้บันทึกในสมุดโทรศัพท์
• กรองเลขต่างประเทศ: บล็อกสายจากหมายเลขต่างประเทศหรือหมายเลขที่อยู่ในรายการที่ผู้ใช้ไม่ต้องการรับ
• จัดการรายการ: จัดการรายการขาว (Whitelist) และรายการบล็อก (Blacklist) เพื่อควบคุมการรับสาย
• Auto-Mute: โหมดปิดเสียงอัตโนมัติสำหรับสายที่ตรวจพบว่าเป็นสแปมหรือโฆษณา

🔍 การตรวจสอบและยืนยัน

• ตรวจสอบหลายแหล่ง: ตรวจสอบหมายเลขโทรศัพท์จากหลายแหล่งข้อมูล เช่น UnknownPhone, Tellows และ TrueCaller เพื่อความแม่นยำ
• STIR/SHAKEN: รองรับมาตรฐาน STIR/SHAKEN เพื่อยืนยัน Caller ID และลดการปลอมแปลงสาย
• ยืนยันชื่อบัญชี: ระบบยืนยันชื่อบัญชีสำหรับการโอนเงินเพื่อป้องกันบัญชีม้า

👥 ชุมชนและฐานข้อมูล

• รายงานชุมชน: ผู้ใช้สามารถรายงานหมายเลขที่ต้องสงสัยหรือยืนยันว่าเป็นหมายเลขปลอดภัยเพื่ออัปเดต
• อัปเดตอัตโนมัติ: อัปเดตฐานข้อมูลอัตโนมัติด้วยข้อมูลจากหน่วยงานกำกับดูแล
• การแจ้งเตือนพิเศษ: การแจ้งเตือนพิเศษสำหรับสายต่างประเทศตามข้อกำหนดของ กสทช. และ PDPC

🌏 ภาษาไทยและความเป็นไทย

• อินเทอร์เฟซภาษาไทย: อินเทอร์เฟซภาษาไทยที่ใช้งานง่ายและเข้าใจง่าย
• คู่มือป้องกัน: ระบบช่วยเหลือและแนะนำการหลีกเลี่ยงกลโกงใหม่ๆ ที่เกิดขึ้นในไทย

เทคโนโลยี (Technology Stack)

Mobile App

• Framework: React Native
• Language: TypeScript
• State Management: Redux Toolkit
• UI Library: React Native Paper

Backend

• Runtime: Node.js with Express
• Database: PostgreSQL
• Cache: Redis
• API: RESTful API

External Services

• UnknownPhone API
• Tellows API
• TrueCaller API (optional)

🏗️ System Architecture

ภาพรวมสถาปัตยกรรม (Architecture Overview)

graph TB
    subgraph "Mobile App Layer"
        Mobile[📱 React Native App<br/>TypeScript]
        Redux[Redux Store]
        UI[React Native Paper UI]

        Mobile --> Redux
        Mobile --> UI
    end

    subgraph "API Layer"
        API[🔌 REST API<br/>Express.js]
        Auth[Authentication]
        RateLimit[Rate Limiter]

        API --> Auth
        API --> RateLimit
    end

    subgraph "Business Logic Layer"
        Controller[Controllers]
        Service[Services]
        Verification[📞 Number Verification<br/>Service]

        Controller --> Service
        Service --> Verification
    end

    subgraph "Data Layer"
        Cache[(🗄️ Redis<br/>Cache)]
        DB[(🗄️ PostgreSQL<br/>Database)]
    end

    subgraph "External Services"
        UnknownPhone[UnknownPhone API]
        Tellows[Tellows API]
        TrueCaller[TrueCaller API]
    end

    Mobile -->|HTTPS/REST| API
    Controller --> Cache
    Controller --> DB
    Verification --> Cache
    Verification --> UnknownPhone
    Verification --> Tellows
    Verification --> TrueCaller
    

    style Mobile fill:#4CAF50
    style API fill:#2196F3
    style DB fill:#FF9800
    style Cache fill:#F44336
    style Verification fill:#9C27B0

Loading

📖 รายละเอียดเพิ่มเติม: ดู Architecture Guide

การติดตั้งและใช้งาน (Installation)

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

• Node.js 18+
• npm หรือ yarn
• React Native development environment
• PostgreSQL 14+
• Redis 6+

ขั้นตอนการติดตั้ง

# Clone repository
git clone https://github.com/Nontawatt/knowcall.git
cd knowcall

# Install dependencies
npm install

# Setup environment variables
cp .env.example .env

# Run database migrations
npm run migrate

# Start development server
npm run dev

โครงสร้างโปรเจค (Project Structure)

knowcall/
├── mobile/          # React Native mobile app
├── backend/         # Node.js backend API
├── shared/          # Shared types and utilities
├── docs/            # Documentation
└── README.md

🚀 เริ่มต้นอย่างรวดเร็ว

# Clone repository
git clone https://github.com/Nontawatt/knowcall.git
cd knowcall

# Install dependencies
npm install

# Setup environment
cp .env.example .env

# Run backend
cd backend && npm run dev

# Run mobile (in new terminal)
cd mobile && npm start

📖 อ่านเพิ่มเติม: Setup Guide

📱 Features

• ✅ ตรวจสอบหมายเลขโทรศัพท์
• ✅ บล็อกสายอัตโนมัติ
• ✅ จัดการ Whitelist/Blacklist
• ✅ Auto-Mute สำหรับสแปม
• ✅ รายงานหมายเลขที่น่าสงสัย
• ✅ ดูประวัติการโทร
• ✅ การแจ้งเตือนแบบ real-time

🎯 สำหรับผู้ใช้

1. ติดตั้งแอป - ดาวน์โหลดจาก App Store หรือ Google Play
2. ตั้งค่า - ปรับแต่งการบล็อกตามต้องการ
3. เริ่มใช้งาน - ปล่อยให้แอปป้องกันให้คุณ

📖 คู่มือ: Getting Started Guide

👨‍💻 สำหรับนักพัฒนา

1. อ่าน Architecture - ARCHITECTURE.md
2. ดู API Docs - API.md
3. ติดตั้ง Development Environment - SETUP.md
4. อ่าน Contributing Guidelines - CONTRIBUTING.md

🛡️ ความปลอดภัย

• 🔒 ไม่เก็บรายชื่อผู้ติดต่อ
• 🔒 ไม่แชร์ข้อมูลส่วนตัว
• 🔒 เข้ารหัสข้อมูลทั้งหมด
• 🔒 Open Source และตรวจสอบได้

📖 เพิ่มเติม: Safety Tips

📊 สถานะการพัฒนา

โปรเจคนี้อยู่ในระหว่างการพัฒนา (Prototype Stage)

ที่ทำเสร็จแล้ว:

• ✅ Mobile App UI (4 screens)
• ✅ Backend API (15+ endpoints)
• ✅ Database Schema
• ✅ Number Verification
• ✅ Call Blocking Logic
• ✅ Whitelist/Blacklist Management
• ✅ Documentation

กำลังพัฒนา:

• 🔄 Real-time notifications
• 🔄 Machine Learning integration
• 🔄 External API integrations
• 🔄 Testing suite

แผนในอนาคต:

• 📋 iOS app release
• 📋 Android app release
• 📋 Integration กับธนาคาร
• 📋 Community features

การมีส่วนร่วม (Contributing)

เรายินดีรับการมีส่วนร่วมจากทุกคน! กรุณาอ่าน CONTRIBUTING.md สำหรับรายละเอียด

ใบอนุญาต (License)

MIT License - ดูรายละเอียดใน LICENSE

ติดต่อ (Contact)

สำหรับคำถามหรือข้อเสนอแนะ กรุณาเปิด issue ใน GitHub

ข้อจำกัดความรับผิดชอบ (Disclaimer)

แอปพลิเคชันนี้เป็นเครื่องมือช่วยเหลือในการป้องกันการหลอกลวง แต่ไม่สามารถรับประกันความปลอดภัย 100% ผู้ใช้ควรใช้วิจารณญาณในการตัดสินใจเสมอ