Projects & Wells
Understanding how Tachapps organizes assets is fundamental to navigating and using the platform effectively.
Projects
A Project is the top-level organizational unit in Tachapps. Think of it as a field, an asset, or a business unit grouping.
Project Structure
Project
├── Wells
│ ├── Well A (producers, injectors, observers)
│ └── Well B
├── Surfaces
│ ├── Top Reservoir
│ └── Base Reservoir
└── Dashboards
├── Production Overview
└── Decline AnalysisCreating a Project
NOTE
Only Admin and Editor roles can create projects.
- Click the + button next to "Projects" in the sidebar
- Enter a Project Name and optional description
- Set the Time Zone for timestamp display
- Click Create
Project Metadata
Each project stores:
| Field | Description |
|---|---|
id | Unique internal identifier |
name | Display name |
timezone | IANA timezone string (e.g., America/Chicago) |
unitSystem | metric or imperial |
createdAt | ISO 8601 timestamp |
updatedAt | ISO 8601 timestamp |
Wells
A Well represents a single wellbore within a project. Wells are the primary data context for production analytics and forecasting.
Well Types
| Type | Description |
|---|---|
| Producer | Hydrocarbon producing well |
| Injector | Water or gas injection well |
| Observer | Monitoring well (pressure, temperature) |
| SWD | Salt water disposal well |
Well Identifiers
Wells can be identified by:
- API Number — 10- or 14-digit US well identifier
- UWI — Unique Well Identifier (Canada)
- Internal ID — Customer-specific well ID from source system
Well Attributes
Each well record contains:
json
{
"id": "well-001",
"name": "Horizon 14-3H",
"apiNumber": "4201500123456",
"type": "producer",
"status": "active",
"latitude": 31.9521,
"longitude": -102.1225,
"spudDate": "2020-03-15",
"firstProductionDate": "2020-07-01",
"perfInterval": { "topMd": 8500, "bottomMd": 9200 }
}Filtering Wells
On any screen showing a well list, you can filter by:
- Well name or API number (search box)
- Well type (producer / injector / observer)
- Well status (active / inactive / shut-in)
- Production rate threshold
- Date range (first production)