Skip to content

Seeed-Solution/seeed-nfc-trace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

16 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

NFC Trace - Intelligent Social Networking System for Exhibitions

A next-generation social networking platform that bridges the physical and digital worlds, designed specifically for exhibition and event scenarios. This system combines the ceremonial value of traditional card exchange with modern digital intelligence, creating an efficient, precise, and engaging social interaction experience.

🎯 Project Vision

In today's digital age, we urgently need a new type of social medium that seamlessly blends physical and digital intelligence. This system preserves the ritualistic aspects of "giving" and "collecting" while enabling efficient, accurate, and engaging digital content interactions.

Designed for MFSZ2025 Exhibition, this platform provides a comprehensive solution for on-site social networking, relationship building, and interactive experiences.

✨ Core Capabilities

1. Rotating Multi-Function System

Implemented - A unique physical interface where users rotate the top PCB to switch between four distinct functional zones:

  • Digital Business Card: Personal card exchange and management
  • Social Network: View and explore social connections
  • Navigation Map: Access exhibition maps and location information
  • Custom Mode: User-defined functionality

The pointer indicates the active function zone, providing an intuitive physical interaction method.

2. One-Person-One-Card System

Implemented - Each user has a unique ID-linked website, creating a personalized digital identity:

  • Individual card assignment with unique ID
  • Free editing of card information (name, contact, avatar, etc.)
  • Persistent digital profile linked to physical NFC device
  • Seamless synchronization between physical and digital identities

3. Social Galaxy Visualization

Implemented - Advanced social network mapping system:

  • Automatically tracks and records NFC interactions between users
  • Transforms individual interactions into relationship lines
  • Connects lines to form a comprehensive social network graph
  • Visualizes connections as a unique "social galaxy" showing user relationships and interconnectedness

4. Battery-Free LED & Display

Implemented - Innovative power-efficient feedback system:

  • LED indicators for visual feedback
  • Digital display (7-segment) for social interaction counting
  • Zero battery required - Powered entirely by phone's NFC coil energy
  • Real-time display of connection statistics and social metrics

5. Pose AI Check-in System

Implemented - AI-powered interactive check-in experience:

  • Dedicated check-in area at exhibition entrance
  • Users strike unique poses in front of camera
  • AI generates personalized stick figure avatars
  • Avatars automatically uploaded to social network for display
  • Creates memorable, unique digital identities for each participant

6. Built-in Exhibition Map

Implemented - Integrated navigation and information system:

  • NFC-triggered access to exhibition maps
  • One-tap access to event information and schedules
  • Real-time activity updates and location guidance
  • Seamless integration with physical device

7. NFC Development Platform

Implemented - Educational and extensible design:

  • Reserved interfaces for custom development
  • Device can function as NFC development board after exhibition use
  • Learning platform for NFC technology and development
  • Open architecture for experimentation and customization

πŸ“Έ Gallery

Device Badges

Badge

Standard NFC Badge Device

Badge 01

Badge Device - View 1

Badge 02

Badge Device - View 2

Exhibition Experience

Party

Exhibition Party Scene - Users interacting with NFC devices

Social Network Visualization

Social Network

Social Galaxy Network Graph - Visualizing connections between participants

Real-time Data Dashboard

Live Dashboard: https://makerfaire-nfc.seeed.cn/web/dashboard.html

View the final results - Real-time data dashboard showcasing social network statistics and analytics from the exhibition

πŸ—οΈ System Architecture

The system consists of three main components:

Cloud Services

  • Frontend: Vue.js-based and antv G6 web application for card management, social network visualization
  • Backend: Go-based API server with Neo4j graph database for relationship tracking
  • Features: Card creation, relationship mapping, access analytics, file management
  • Documentation: Cloud Services

Embedded Devices (Implemented)

  • Firmware: STC8G microcontroller-based firmware with persistent counter and display control
  • Hardware Features: Rotating PCB interface, 3-digit 7-segment display, NFC integration
  • Power Management: Battery-free operation powered by NFC coil energy
  • Storage: EEPROM-based persistent counter with auto-increment on power-up
  • Documentation: Embedded System

Pose AI Check-in System (Implemented)

  • AI Model: YOLO11m-pose for real-time human pose estimation and keypoint detection
  • Core Features:
    • Real-time camera-based pose detection with 17 keypoint tracking
    • Multi-person scenario handling with intelligent main person selection
    • Pose stability validation requiring 3-second pose hold
    • Personalized stick figure avatar generation with user profile integration
  • NFC Integration: Automatic user identification via NFC card reading
  • Workflow:
    • Reads user UUID from NFC card β†’ Fetches user profile β†’ Detects pose β†’ Generates avatar β†’ Uploads to OSS β†’ Updates user avatar URL
  • Technology Stack: Python, OpenCV, Ultralytics YOLO, AliCloud OSS
  • Documentation: Pose Generate System

πŸ“ Project Structure

seeed-nfc-trace/
β”œβ”€β”€ backend/                    # Go backend service
β”‚   β”œβ”€β”€ cmd/                    # Application entry point
β”‚   β”‚   └── main.go            # Main application file
β”‚   β”œβ”€β”€ internal/               # Internal application code
β”‚   β”‚   β”œβ”€β”€ api/               # API handlers and routes
β”‚   β”‚   β”œβ”€β”€ cache/             # Redis cache implementation
β”‚   β”‚   β”œβ”€β”€ config/            # Configuration management
β”‚   β”‚   β”œβ”€β”€ database/          # Database initialization and Neo4j
β”‚   β”‚   β”œβ”€β”€ middleware/        # HTTP middleware
β”‚   β”‚   β”œβ”€β”€ models/            # Data models
β”‚   β”‚   └── services/          # Business logic services
β”‚   β”œβ”€β”€ pkg/                   # Public packages
β”‚   β”‚   β”œβ”€β”€ common/            # Common utilities
β”‚   β”‚   └── utils/             # Utility functions
β”‚   β”œβ”€β”€ config/                # Configuration files
β”‚   β”œβ”€β”€ scripts/               # Backend utility scripts
β”‚   β”œβ”€β”€ go.mod                 # Go module dependencies
β”‚   └── Makefile               # Build scripts
β”‚
β”œβ”€β”€ frontend/                   # Vue.js frontend application
β”‚   β”œβ”€β”€ src/                   # Source code
β”‚   β”‚   β”œβ”€β”€ api/               # API wrappers and request handlers
β”‚   β”‚   β”œβ”€β”€ views/             # Page views and components
β”‚   β”‚   └── utils/             # Utility functions
β”‚   β”œβ”€β”€ public/                # Static assets and HTML files
β”‚   β”œβ”€β”€ package.json           # Dependencies configuration
β”‚   β”œβ”€β”€ vite.config.js         # Vite build configuration
β”‚   └── index.html             # Entry HTML file
β”‚
β”œβ”€β”€ pose_generate/             # Pose AI check-in system
β”‚   β”œβ”€β”€ models/                # AI pose estimation models
β”‚   β”œβ”€β”€ utils/                 # Utility scripts and NFC helpers
β”‚   β”œβ”€β”€ icon/                  # Icon assets
β”‚   β”œβ”€β”€ images/                # Image assets
β”‚   β”œβ”€β”€ main.py                # Main program script
β”‚   β”œβ”€β”€ process.py             # Image processing
β”‚   └── read_nfc.py            # NFC reading functionality          
β”‚
β”œβ”€β”€ embedded/                   # Embedded hardware and firmware
β”‚   β”œβ”€β”€ firmware/              # Microcontroller firmware
β”‚   β”‚   └── stc8g/            # STC8G MCU firmware project
β”‚   β”œβ”€β”€ hardware/              # PCB design files
β”‚   β”‚   β”œβ”€β”€ evo_linkcard_main/          # Main board KiCad project
β”‚   β”‚   └── evo_linkcard_rotary_knob/   # Rotary knob variant
β”‚   └── tools/                 # Development tools
β”‚       └── NFC_Tools_Pro.apk  # NFC programming tool
β”‚
β”œβ”€β”€ docs/                       # Project documentation
β”‚   β”œβ”€β”€ cloud_services.md      # Cloud Services details
β”‚   β”œβ”€β”€ embedded.md            # Embedded system documentation
β”‚   β”œβ”€β”€ pose_generate.md              # Pose system documentation
β”‚   └── images/                # Documentation images
β”œβ”€β”€ docker-compose.yml         # Docker Compose configuration
β”œβ”€β”€ Dockerfile                 # Production Dockerfile
β”œβ”€β”€ nginx.conf                 # Nginx configuration
β”œβ”€β”€ supervisord.conf           # Supervisord configuration
β”œβ”€β”€ release.sh                 # Release script
β”œβ”€β”€ release-production.sh      # Production release script
└── README.md                  # Project documentation

🀝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/YourFeature)
  3. Commit your changes (git commit -m 'Add YourFeature')
  4. Push to the branch (git push origin feature/YourFeature)
  5. Open a Pull Request

Note: This project is actively developed for MFSZ2025 exhibition. Features and APIs may change during development. Please test thoroughly before production use.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •