CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Vue.js 2 + UniApp mobile application called "GS-MES-AP" (StandardPda-Browse) for manufacturing quality control and warehouse management. The application is designed for PDA (Personal Digital Assistant) devices used in manufacturing environments.

Key Technologies

• Framework: Vue.js 2 + UniApp (uni-app v2.0.2)
• State Management: Vuex
• UI Components: uView UI v2.0.38, Vant v2.13.7
• Build Tool: Vue CLI with @dcloudio/vue-cli-plugin-uni
• Platform: Multi-platform (Android/iOS app, H5, various mini-programs)

Development Commands

Since this is a UniApp project, standard npm scripts are not present. Development should be done through:
- HBuilderX IDE: The recommended development environment for UniApp
- Build: Use HBuilderX to build for different platforms
- Debug: Use HBuilderX's built-in debugger or device debugging

Architecture Overview

Core Structure

• Entry Point: main.js - Sets up Vue instance, store, and global prototypes
• State Management: store/index.js - Vuex store with server configuration
• Routing: pages.json - UniApp page configuration (not Vue Router)
• App Configuration: manifest.json - App metadata and platform-specific settings

Key Directories

• pages/ - Application pages organized by feature modules
• BasePages/ - Core pages (login, main, user profile)
• QC/ - Quality Control modules (来料检验, 首检, 巡检, 入库检)
• Warehouse/ - Warehouse management modules
• fileView/ - File viewing components (PDF, Excel, Word, images)
• components/ - Reusable UI components
• common/ - Shared utilities and global mixins
• utils/ - Utility functions for printing, scanning, messaging
• static/ - Static assets (images, icons, sounds)

Quality Control (QC) Modules

• LLJ (来料检验): Incoming material inspection
• SJ (首检): First article inspection
• XJ (巡检): Patrol inspection
• RKJ (入库检): Warehouse inspection
• THL (退换料): Return/exchange material confirmation

Core Features

• Barcode/QR Code Scanning: Custom PDA integration via utils/scanCode.js
• Image Capture: Camera integration for quality documentation
• File Viewing: PDF, Excel, Word, and image preview capabilities
• Bluetooth Printing: Barcode and receipt printing via components/kk-printer/
• Offline Storage: Local data persistence using uni.storage APIs

API Integration

• Server Configuration: Located in store/index.js
• Request Handling: Global methods $get, $post, $uni_request in main.js
• Authentication: User info stored in $loginInfo prototype

PDA Hardware Integration

• Barcode Scanning: Android broadcast receiver implementation in utils/scanCode.js
• Camera Access: Native camera API through UniApp
• Bluetooth Printing: Thermal printer integration

Development Guidelines

Working with QC Modules

Each QC module follows a consistent pattern:
- List.vue - Data listing with pull-to-refresh
- Add.vue - Form for creating new entries
- detail.vue - Detailed view/editing
- ImageItem.vue - Image capture and upload

Adding New Features

1. Create page in appropriate pages/ subdirectory
2. Add page configuration to pages.json
3. Use global API methods ($get, $post) for server communication
4. Follow existing patterns for form handling and data validation

Testing

• Test on actual PDA devices for barcode scanning functionality
• Verify camera and printing features on target hardware
• Test offline storage and sync capabilities

Important Notes

• This is a PDA-specific application with hardware dependencies
• Server API endpoint is configured in store/index.js
• Image uploads are base64 encoded and sent to /Base/saveImage
• All text content is in Chinese (simplified)
• Application supports multiple deployment targets (Android, iOS, H5)