update

docs/architecture.md

@@ -0,0 +1,30 @@
+# 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