CaCrFeedFormula Project Overview

CaCrFeedFormula Project Overview

Intelligent Feed Formula Optimization System built with Tauri + Rust + React TypeScript.

Project Context

CaCrFeedFormula is an industrial-grade desktop application for feed formula optimization, integrating AI-assisted optimization, linear programming (HiGHS solver), and comprehensive feed management capabilities.

Core Technology Stack

Backend (Rust 2021):

• Framework: Tauri 2.9.0 + Tokio 1.37 (full async runtime)
• Database: SQLite + SQLx 0.7 (compile-time type safety)
• Optimization: HiGHS 1.12 (industrial-grade LP solver)
• Caching: Moka 0.12 (high-performance concurrent cache)
• Type Binding: specta 2.0 + tauri-specta 2.0 (auto TypeScript generation)
• AI Integration: reqwest + eventsource-stream (streaming responses)
• Parallel Compute: Rayon 1.8

Frontend (React 19.1 + TypeScript 5.8):

• UI Framework: Ant Design 5.26 + Tailwind CSS 4.1
• State Management: TanStack Query 5.17
• Build Tool: Vite 7.0
• Visualization: Recharts 2.15
• Animation: Framer Motion 11

Project Structure

cacrfeedformula/
├── src/                          # Rust backend source
│   ├── ai/                       # AI service module
│   ├── database/                 # Database connection
│   ├── formula/                  # Formula optimization core
│   ├── material/                 # Material management
│   ├── species/                  # Species management
│   ├── factory/                  # Factory management
│   ├── premix/                   # Premix design
│   ├── profit/                   # Profit/​loss analysis
│   ├── prediction/               # Nutrition prediction
│   ├── production_batch/         # Production batch management
│   └── system/                   # System services
├── frontend/                     # React frontend source
│   └── src/
│       ├── components/           # React components
│       │   ├── AIChat/          # AI chat component
│       │   └── common/          # Common components
│       └── bindings.ts          # Auto-generated type bindings
├── migrations/                   # Database migrations
└── .claude/
    ├── skills/                   # Custom Claude Code skills
    └── rules/                    # Detailed development standards

Core Features

1. Formula Optimization System

• Linear programming optimization (cost minimization)
• Manual formula design
• Premix reverse calculation design
• Formula version management
• Formula analysis and reporting
• 167 Tauri commands for comprehensive formula operations

2. Data Management

• Material management (built-in China Feed Composition & Nutrition Value Database)
• Species management (multiple species, growth stages, nutrition standards)
• Factory management (multi-factory data isolation)
• Production batch management (batch lifecycle, material requirement calculation)
• Inventory management (stock check, variance analysis, purchase planning)

3. Analysis & Decision Support

• Profit/​loss analysis (comprehensive cost accounting, real-time P&L)
• Nutrition prediction (NRC-based energy prediction)
• Sensitivity analysis (shadow prices, bottleneck constraint identification)

4. AI Intelligent Assistant

• Context-aware professional feed formula consultation
• Streaming responses with typewriter effect
• Multi-turn conversations
• Supports OpenAI, DeepSeek, OpenRouter platforms

Project Characteristics

1. Desktop Application: Not a web app; cross-platform desktop app built with Tauri
2. High-Performance Computing: Rust backend ensures speed and stability
3. Type Safety: specta auto-generates TypeScript types, ensuring frontend-backend type consistency
4. Async-First: Comprehensive use of Tokio async runtime
5. Industrial-Grade Optimization: HiGHS solver supports large-scale formula optimization
6. AI Integration: Streaming AI responses with real-time typewriter effect

Development Workflow Context

Typical Development Scenarios:

• Formula Engine: Implementing complex linear programming algorithms with HiGHS
• Material Database: Managing large datasets with SQLite + SQLx
• Desktop UI: Building responsive Ant Design interfaces with React 19
• Tauri Commands: Creating type-safe Rust ↔ TypeScript communication
• AI Features: Integrating streaming AI responses into desktop workflows
• Batch Processing: Handling production batch calculations and scheduling

Key Integration Points:

• Rust ↔ TypeScript: specta generates bindings.ts after every Rust change
• Database ↔ Business Logic: SQLx macros provide compile-time SQL validation
• Frontend ↔ Backend: TanStack Query manages server state via Tauri commands
• AI ↔ User: Streaming SSE responses with real-time UI updates

Project Scale

• 167 Tauri commands across 10 modules
• Comprehensive feed database with 1000+ materials
• Multi-tenancy support with factory-level data isolation
• Complex optimization handling 100+ variables and 50+ constraints

Development Standards

The project follows strict development standards documented in .claude/​rules/:

• Rust backend standards (02-rust-backend-standards.md)
• React frontend standards (03-react-frontend-standards.md)
• Database standards (04-database-standards.md)
• LSP usage standards (05-lsp-usage-standards.md)

All these standards are enforced via automated hooks and skills.

When This Context Is Useful

This project overview is automatically loaded to help Claude understand:

• Architecture decisions when proposing changes
• Technology choices when solving problems
• Integration patterns when adding features
• Scale considerations when optimizing performance
• Domain context (feed formulation, nutrition, optimization)

This knowledge enables Claude to make more informed, project-appropriate recommendations without requiring repeated explanations of the project's nature and structure.