# CLAUDE.md

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

## Project Overview

This is a **PDA (Personal Digital Assistant) web application** for the LongWei MES (Manufacturing Execution System). It's built as an ASP.NET Web Forms application targeting .NET Framework 4.8, designed for mobile/PDA devices used in manufacturing environments.

The application handles various manufacturing operations including:
- Material receiving/shipping (收货/发货)  
- Production reporting (生产报工)
- Quality control inspections (质量检验)
- Barcode scanning and printing
- Bluetooth device integration

## Architecture & Technology Stack

### Backend
- **ASP.NET Web Forms** (.NET Framework 4.8)
- **Master Page**: `Mst.master` - provides common layout and references
- **Code-behind**: C# files in `App_Code/` (e.g., `Utility.cs`)
- **Configuration**: `Web.config` for app settings, `Scripts/config.js` for API endpoints

### Frontend
- **Vue.js 2.x** - primary frontend framework
- **Vant UI** - mobile UI component library for Vue
- **Axios** - HTTP client for API calls
- **Flexible.js** - mobile responsive layout
- **Custom components**: Navigation, loading, back button functionality

### API Integration
- **Primary API**: Configurable in `Scripts/config.js` (currently `localhost:5204/api/`)
- **PC Backend**: Separate API for PC-related operations (`192.168.0.51:8081/`)
- **Authentication**: Cookie-based with `loginGuid` and `loginAccount`
- **HTTP wrapper**: `Vue.prototype.AxiosHttp` for standardized API calls

## Directory Structure

```
/H5/                    - Main application pages (.aspx files)
/H5/Js/                 - Page-specific JavaScript/Vue.js files
/Scripts/               - Shared JavaScript libraries and config
/Images/                - Static assets and CSS
/App_Code/              - Server-side utility classes
/audio/                 - Sound files for success/error feedback
```

## Development Workflow

### Building & Running
- **Development**: Open `GsPdaApp.sln` in Visual Studio
- **Debug mode**: Set in `Web.config` (`debug="true"`)
- **Local server**: Uses IIS Express (typically port 51933)
- **No build scripts**: Standard ASP.NET Web Forms compilation

### Key Configuration Files
- `Web.config` - Server configuration, compilation settings
- `Scripts/config.js` - API endpoints, global Vue.js extensions
- `Mst.master` - Common page layout and script references

### Code Conventions
- **Page structure**: Each `.aspx` page has corresponding `.aspx.cs` (C#) and `.js` (Vue.js) files
- **Vue instances**: Named `vm`, mounted to `#app` element
- **API calls**: Use `this.AxiosHttp(method, url, params)` wrapper
- **Authentication**: Check with `this.CHECKLOGIN()` or `this.GetLoginInfor()`
- **Navigation**: Use `this.GoBack()` for consistent back navigation
- **Styling**: Mobile-first with Vant UI components, custom CSS in `/Images/Style.css`

## Common Development Patterns

### Page Structure Template
```javascript
var vm = new Vue({
    el: '#app',
    data: function() {
        return {
            isLoading: false,
            // page-specific data
        }
    },
    mounted() {
        this.CHECKLOGIN(); // Verify user authentication
        // initialization logic
    },
    methods: {
        // page-specific methods
    }
});
```

### API Integration
```javascript
// Standard API call pattern
this.AxiosHttp('get', 'endpoint', params).then(res => {
    if (res.success) {
        // handle success
        this.$playSound('success');
    } else {
        // handle error  
        this.$playSound('error');
        this.$toast.fail(res.message);
    }
});
```

### Audio Feedback
- Success operations: `this.$playSound('success')` (plays `/audio/OK.wav`)
- Error operations: `this.$playSound('error')` (plays `/audio/NG.wav`)

### Barcode/Printing Integration
- Printing functionality integrated via `uni.webView.postMessage()`
- Print templates defined in `Vue.prototype.sendPrintMessage`
- Barcode scanning integrated with mobile hardware

## Bluetooth Integration
- Located in `/H5/Bluetooth/` directory  
- Configuration via `BluetoothConfig.xml`
- MAC address management through dedicated pages

## Authentication & Session Management
- **Login page**: `/UserLogin.aspx`  
- **Session storage**: Browser cookies (`loginGuid`, `loginAccount`)
- **Auto-redirect**: Unauthenticated users redirected to login
- **Session validation**: `CHECKLOGIN()` method on each page

## Mobile Optimization
- **Viewport**: Configured for mobile devices, no user scaling
- **Responsive**: Uses lib-flexible for different screen sizes  
- **Touch-friendly**: Vant UI components optimized for touch
- **Performance**: Minimized resource loading, efficient Vue.js patterns