arbit/docs/architecture.md

Architecture

Arbit is a small internal Django app for tracking thrift acquisitions through resale.

Goals

• Fast item entry
• Editable templates for recurring item types
• Searchable inventory with practical filters
• Profit tracking and resale pricing guidance
• Simple per-item attribution to the user who created the item

Stack

• Django for server-rendered forms, auth, and admin
• SQLite for local development, PostgreSQL for production
• HTMX later if the team wants faster inline editing without a full SPA

Components

• inventory app for domain models and dashboard views
• Django auth for login/logout
• Django admin for internal management and emergency data editing
• Templates for the main dashboard and item forms

Phase 1 Boundaries

• No role-based permissions beyond standard authenticated access
• No marketplace posting automation
• Pricing suggestions are advisory and can be overridden manually