[{"data":1,"prerenderedAt":640},["ShallowReactive",2],{"guide:en:inventory-management/sites":3},{"id":4,"title":5,"body":6,"description":632,"extension":633,"meta":634,"navigation":635,"path":636,"seo":637,"stem":638,"__hash__":639},"guide_en/en/user/inventory-management/sites.md","Sites — Storage Locations for Inventory",{"type":7,"value":8,"toc":611},"minimark",[9,14,18,23,34,45,48,53,61,77,82,88,92,98,109,113,119,122,126,131,163,168,182,187,205,209,214,235,241,260,265,279,283,287,316,320,343,347,370,374,397,401,404,423,426,437,441,444,458,464,472,476,479,485,488,499,503,506,526,529,540,544,549,563,568,579,584,595,600],[10,11,13],"h1",{"id":12},"sites","Sites",[15,16,17],"p",{},"Sites are the named locations where inventory exists at any given moment. A site might be a central warehouse, a temporary field staging area near an active project, a worker's personal inventory (created automatically when they receive their first QR pickup), or a vehicle carrying materials for a traveling crew. Every stock balance and movement is tied to a specific site, giving you a live view of where your materials are across your entire operation.",[19,20,22],"h2",{"id":21},"site-types-implicit","Site Types (Implicit)",[24,25,30],"pre",{"className":26,"code":28,"language":29},[27],"language-text","Site Hierarchy:\n\nCentral Warehouse\n├── Large capacity, controlled access\n├── Staff with canFacilitatePickups permission\n└── Primary receiving point (suppliers → warehouse)\n\nField Staging Sites\n├── Temporary, project-specific\n├── Medium capacity\n└── Transfers from warehouse → consumption by workers\n\nPersonal Sites (Workers)\n├── Auto-created on first QR pickup\n├── Mobile inventory (follows worker)\n└── Consumption transactions (work depletes stock)\n\nVehicle Sites\n├── Reference to vehicle asset or operator\n├── Mobile storage (traveling crews)\n└── Stock moves with vehicle\n","text",[31,32,28],"code",{"__ignoreMap":33},"",[15,35,36,41],{},[37,38],"img",{"alt":39,"src":40},"Sites List","/guide/inventory-management/sites-list.png",[42,43,44],"em",{},"Sites page showing storage locations with types and capacity information",[15,46,47],{},"Aptli uses implicit site types based on fields present:",[49,50,52],"h3",{"id":51},"physical-sites","Physical Sites",[15,54,55,56,60],{},"Sites with ",[57,58,59],"strong",{},"geometry"," (GPS coordinates or area polygons):",[62,63,64,68,71,74],"ul",{},[65,66,67],"li",{},"Central warehouses",[65,69,70],{},"Regional distribution centers",[65,72,73],{},"Field staging areas",[65,75,76],{},"Storage yards",[15,78,79],{},[57,80,81],{},"Example:",[24,83,86],{"className":84,"code":85,"language":29},[27],"Name: \"Central Warehouse\"\nGeometry: Point at (lat: 40.7128, lng: -74.0060)\nAddress: \"123 Storage Way, New York, NY\"\n",[31,87,85],{"__ignoreMap":33},[49,89,91],{"id":90},"personal-sites","Personal Sites",[15,93,55,94,97],{},[57,95,96],{},"reference"," to user or vehicle (no geometry):",[62,99,100,103,106],{},[65,101,102],{},"Individual worker inventory",[65,104,105],{},"Vehicle inventory",[65,107,108],{},"Mobile equipment",[15,110,111],{},[57,112,81],{},[24,114,117],{"className":115,"code":116,"language":29},[27],"Name: \"John's Personal Inventory\"\nReference: { user_id: \"...\" }\n",[31,118,116],{"__ignoreMap":33},[15,120,121],{},"This design avoids enum sync issues - the presence of geometry vs. reference determines implicit behavior.",[19,123,125],{"id":124},"site-fields","Site Fields",[15,127,128],{},[57,129,130],{},"Basic Information:",[62,132,133,139,145,151,157],{},[65,134,135,138],{},[57,136,137],{},"Name"," - Descriptive name",[65,140,141,144],{},[57,142,143],{},"Type"," - Category for filtering (warehouse, field, vehicle, personal)",[65,146,147,150],{},[57,148,149],{},"Geometry"," - GPS coordinates or polygon area (optional)",[65,152,153,156],{},[57,154,155],{},"Reference"," - Link to user or vehicle (optional)",[65,158,159,162],{},[57,160,161],{},"Address"," - Physical address for warehouses",[15,164,165],{},[57,166,167],{},"Inventory Tracking:",[62,169,170,176],{},[65,171,172,175],{},[57,173,174],{},"Stock Items"," - Array of resources held at this site (managed via transactions)",[65,177,178,181],{},[57,179,180],{},"Capacity"," - Optional maximum volume/units (alerts when approaching limit)",[15,183,184],{},[57,185,186],{},"Access Control:",[62,188,189,195],{},[65,190,191,194],{},[57,192,193],{},"Authorized Personnel"," - Users who can create receipts/adjustments at this site",[65,196,197,200,201,204],{},[57,198,199],{},"Requires Supervision"," - If true, ",[31,202,203],{},"canFacilitatePickups"," permission required for transfers",[19,206,208],{"id":207},"creating-sites","Creating Sites",[15,210,211],{},[57,212,213],{},"Physical Site:",[215,216,217,220,223,226,229,232],"ol",{},[65,218,219],{},"Navigate to Inventory → Sites",[65,221,222],{},"Click \"Add Site\"",[65,224,225],{},"Enter name, type, address",[65,227,228],{},"Click map to set geometry (point or polygon)",[65,230,231],{},"Set capacity if applicable",[65,233,234],{},"Save",[15,236,237,240],{},[57,238,239],{},"Personal Site (Auto-Created):","\nWhen worker scans first pickup QR code:",[62,242,243,246,254,257],{},[65,244,245],{},"Personal site created automatically",[65,247,248,249,253],{},"Named: \"",[250,251,252],"span",{},"Worker Name","'s Personal Inventory\"",[65,255,256],{},"Reference set to worker's user ID",[65,258,259],{},"No manual creation needed",[15,261,262],{},[57,263,264],{},"Vehicle Site:",[215,266,267,270,273,276],{},[65,268,269],{},"Create site with reference to vehicle asset",[65,271,272],{},"Or reference to user who operates vehicle",[65,274,275],{},"Stock items track what's in vehicle",[65,277,278],{},"Useful for mobile inventory (traveling crews)",[19,280,282],{"id":281},"site-usage-patterns","Site Usage Patterns",[49,284,286],{"id":285},"central-warehouse","Central Warehouse",[62,288,289,295,301,307],{},[65,290,291,294],{},[57,292,293],{},"Purpose:"," Primary receiving and storage",[65,296,297,300],{},[57,298,299],{},"Characteristics:"," Large capacity, controlled access, fixed location",[65,302,303,306],{},[57,304,305],{},"Transactions:"," Receipts from suppliers, transfers to workers/field sites",[65,308,309,312,313,315],{},[57,310,311],{},"Staff:"," Warehouse managers with ",[31,314,203],{}," permission",[49,317,319],{"id":318},"field-staging-site","Field Staging Site",[62,321,322,327,332,337],{},[65,323,324,326],{},[57,325,293],{}," Temporary storage near active work area",[65,328,329,331],{},[57,330,299],{}," Medium capacity, project-specific, temporary",[65,333,334,336],{},[57,335,305],{}," Transfers from warehouse, consumption by workers",[65,338,339,342],{},[57,340,341],{},"Lifecycle:"," Created for project, emptied when project completes",[49,344,346],{"id":345},"personal-site-worker","Personal Site (Worker)",[62,348,349,354,359,364],{},[65,350,351,353],{},[57,352,293],{}," Mobile inventory for individual",[65,355,356,358],{},[57,357,299],{}," Small capacity, moves with worker, worker-specific",[65,360,361,363],{},[57,362,305],{}," Pickups via QR scan, consumption via reports, returns to warehouse",[65,365,366,369],{},[57,367,368],{},"Access:"," Only the worker can consume from their personal site",[49,371,373],{"id":372},"vehicle-site","Vehicle Site",[62,375,376,381,386,391],{},[65,377,378,380],{},[57,379,293],{}," Inventory traveling with crew vehicle",[65,382,383,385],{},[57,384,299],{}," Medium capacity, moves with vehicle, crew-specific",[65,387,388,390],{},[57,389,305],{}," Similar to personal site but for multi-person crews",[65,392,393,396],{},[57,394,395],{},"Tracking:"," Useful for compliance (what materials are on-site)",[19,398,400],{"id":399},"site-transactions","Site Transactions",[15,402,403],{},"View all activity at a site:",[62,405,406,409],{},[65,407,408],{},"Navigate to site detail view",[65,410,411,412],{},"\"Transaction History\" shows:\n",[62,413,414,417,420],{},[65,415,416],{},"All receipts, transfers in/out, consumptions",[65,418,419],{},"Current stock items and volumes",[65,421,422],{},"Personnel who performed transactions",[15,424,425],{},"Helps answer:",[62,427,428,431,434],{},[65,429,430],{},"What inventory currently at this site?",[65,432,433],{},"What left the site recently?",[65,435,436],{},"Who received materials from this site?",[19,438,440],{"id":439},"gps-tracking-for-transfers","GPS Tracking for Transfers",[15,442,443],{},"When QR pickup scanned:",[62,445,446,449,452,455],{},[65,447,448],{},"Each QR pickup scan records the GPS coordinates where it occurred",[65,450,451],{},"If the site has a defined location, the system validates the worker was physically present",[65,453,454],{},"The audit trail shows where each scan took place",[65,456,457],{},"Helps detect unauthorized remote QR sharing",[15,459,460,463],{},[57,461,462],{},"Geofence Validation (Optional):","\nConfigure warehouse to require scan within 50m radius",[62,465,466,469],{},[65,467,468],{},"Prevents remote QR scanning (screenshot sent to friend)",[65,470,471],{},"Transaction rejected if GPS too far from site geometry",[19,473,475],{"id":474},"stock-item-organization","Stock Item Organization",[15,477,478],{},"Each site contains stock items:",[24,480,483],{"className":481,"code":482,"language":29},[27],"Central Warehouse\n  ├── Cat6 Cable: 500m\n  ├── Mounting Brackets: 200 units\n  └── Installation Kits: 15 units\n\nJohn's Personal Inventory\n  ├── Cat6 Cable: 10m\n  └── Mounting Brackets: 5 units\n",[31,484,482],{"__ignoreMap":33},[15,486,487],{},"Navigation:",[62,489,490,493,496],{},[65,491,492],{},"From site: view all stock items at this location",[65,494,495],{},"From stock item: view which site holds this inventory",[65,497,498],{},"Bi-directional relationship",[19,500,502],{"id":501},"site-capacity-alerts","Site Capacity Alerts",[15,504,505],{},"Set capacity limits to prevent overcrowding:",[62,507,508,514,520],{},[65,509,510,513],{},[57,511,512],{},"Volume-Based:"," Total cubic meters/feet",[65,515,516,519],{},[57,517,518],{},"Weight-Based:"," Maximum kilograms/pounds",[65,521,522,525],{},[57,523,524],{},"Count-Based:"," Maximum number of units",[15,527,528],{},"When approaching capacity:",[62,530,531,534,537],{},[65,532,533],{},"Alert shown in site view",[65,535,536],{},"Prevents additional receipts if over capacity",[65,538,539],{},"Prompts redistribution to other sites",[19,541,543],{"id":542},"best-practices","Best Practices",[15,545,546],{},[57,547,548],{},"Name Consistently:",[62,550,551,554,560],{},[65,552,553],{},"Physical sites: Include location identifier (e.g., \"Warehouse - NYC\", \"Field Site - Project Alpha\")",[65,555,556,557,559],{},"Personal sites: Auto-generated names work well (\"",[250,558,137],{},"'s Inventory\")",[65,561,562],{},"Vehicle sites: Include vehicle ID (e.g., \"Truck 42\", \"Van - License ABC123\")",[15,564,565],{},[57,566,567],{},"Use Geometry for Physical Sites:",[62,569,570,573,576],{},[65,571,572],{},"Enables proximity filtering (find nearest site with resource)",[65,574,575],{},"Validates QR pickups (worker at correct location)",[65,577,578],{},"Shows sites on map view",[15,580,581],{},[57,582,583],{},"Limit Personal Site Creation:",[62,585,586,589,592],{},[65,587,588],{},"Only create when worker needs inventory accountability",[65,590,591],{},"Not all users need personal sites",[65,593,594],{},"Created automatically on first pickup (don't pre-create)",[15,596,597],{},[57,598,599],{},"Audit Regularly:",[62,601,602,605,608],{},[65,603,604],{},"Review sites with zero stock items (unused sites)",[65,606,607],{},"Archive field sites after project completion",[65,609,610],{},"Reconcile personal sites during cycle counts",{"title":33,"searchDepth":612,"depth":612,"links":613},2,[614,619,620,621,627,628,629,630,631],{"id":21,"depth":612,"text":22,"children":615},[616,618],{"id":51,"depth":617,"text":52},3,{"id":90,"depth":617,"text":91},{"id":124,"depth":612,"text":125},{"id":207,"depth":612,"text":208},{"id":281,"depth":612,"text":282,"children":622},[623,624,625,626],{"id":285,"depth":617,"text":286},{"id":318,"depth":617,"text":319},{"id":345,"depth":617,"text":346},{"id":372,"depth":617,"text":373},{"id":399,"depth":612,"text":400},{"id":439,"depth":612,"text":440},{"id":474,"depth":612,"text":475},{"id":501,"depth":612,"text":502},{"id":542,"depth":612,"text":543},"Sites are the named locations where inventory is held — warehouses, field staging areas, individual worker personal inventory, and vehicles. Each site's stock is updated in real time by transactions.","md",{},true,"/en/user/inventory-management/sites",{"title":5,"description":632},"en/user/inventory-management/sites","pzrV8l0tGG6U9rofK8mb-AMryHneO_kKWe8vyMTnb20",1776295548540]