Stock Verify Application (v2.1)

✨ This repository is available as a GitHub template! Click "Use this template" to create your own Stock Verify instance. See docs/STARTUP_GUIDE.md for setup instructions.

---

🎵 NEW VIBE CODER? START HERE! 👈

Complete Vibe Coding Guides:

• 📍 START HERE ← Your personalized roadmap and next steps!
• ⚡ Quick Start: Vibe Coding Today - Get coding in 2 hours
• 🎯 Vibe Coding Next Steps Guide - 30-day learning path
• 🗺️ Visual Roadmap - See the big picture
• 🛠️ Vibe Coding Setup - AI tools configuration

---

📚 Documentation (v2.1)

Core Documentation

• Codebase Memory: Architecture, Tech Stack, and Data Models.
• Cursor Rules: AI behavior and coding standards.
• Verified Coding Policy: Testing and verification requirements.
• Changelog: Version history.

Production & Deployment

• Production Deployment Guide: Complete deployment instructions for production.
• Production Readiness Checklist: Step-by-step verification before going live.
• Feature Roadmap: Planned features and upgrade recommendations.

---

🚀 Quick Start

For New Deployments (Using Template)

1. See docs/STARTUP_GUIDE.md for complete setup guide
2. Run ./init-new-instance.sh to initialize your instance

For Development

One-Click Startup (Recommended)

make start

This starts Backend, Frontend, and Database services, automatically configuring the network.

Individual Services

• Backend: make backend (Port 8001)
• Frontend: make frontend (Port 8081 - LAN Mode)
• Fix Expo: make fix-expo (Tunnel Mode for connection issues)
• Stop All: make stop

Network Configuration (Dynamic IP)

The system now automatically detects your IP address to allow mobile devices to connect:

1. Backend detects its LAN IP on startup and writes to backend_port.json.
2. Frontend reads this file to configure the API client.
3. Docker/CI: Set EXPO_PUBLIC_BACKEND_URL to override this behavior.

⚙️ Configuration

• Backend Port: 8001 (Default)
• SQL Server: configured in backend/config.py (Default: 192.168.1.109)
• Frontend: Expo SDK 54 (Stable)

🧹 Maintenance

To archive old documentation:

python scripts/cleanup_old_docs.py

Kill frontend

lsof -ti :8081,19000,19001,19002,19006 | xargs kill -9