init local package repo

2026-02-27 12:44:50 -06:00
commit 7027efd777
34 changed files with 20093 additions and 0 deletions
@@ -0,0 +1,33 @@
+# Deploy on StartOS 0.3.5 (Raspberry Pi)
+
+## 1) Build the package on your Mac
+```bash
+cd /Users/macpro/Projects/CRM
+make -C start9/0.3.5 package
+```
+
+This creates:
+- `start9/0.3.5/image.tar`
+- `start9/0.3.5/ten31-database.s9pk`
+
+## 2) Upload package to StartOS
+1. Open StartOS web UI.
+2. Go to Services -> Sideload Package (or equivalent 0.3.5 menu).
+3. Upload `ten31-database.s9pk`.
+4. Install and start the service.
+
+## 3) First run
+1. Open the service UI.
+2. Create first admin account on the login screen.
+3. In Settings, run one manual backup immediately.
+
+## 4) Data persistence contract
+- App DB path: `/data/crm.db`
+- Backup path: `/data/backups`
+
+Because these are in the persistent service volume, app restarts/upgrades do not erase data.
+
+## 5) Before any upgrade/migration
+1. Run manual backup in-app.
+2. Export fundraising state in-app.
+3. Keep both files off-device as recovery copy.
@@ -0,0 +1,25 @@
+FROM python:3.11-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    CRM_ENV=production \
+    CRM_HOST=0.0.0.0 \
+    CRM_PORT=8080 \
+    CRM_DATA_DIR=/data \
+    CRM_FRONTEND_DIR=/app/frontend
+
+WORKDIR /app
+
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends ca-certificates curl \
+  && rm -rf /var/lib/apt/lists/*
+
+COPY backend/server.py /app/backend/server.py
+COPY frontend /app/frontend
+COPY start9/0.3.5/docker_entrypoint.sh /usr/local/bin/docker_entrypoint.sh
+COPY start9/0.3.5/healthcheck.sh /usr/local/bin/healthcheck.sh
+
+RUN chmod +x /usr/local/bin/docker_entrypoint.sh /usr/local/bin/healthcheck.sh
+
+EXPOSE 8080
+ENTRYPOINT ["/usr/local/bin/docker_entrypoint.sh"]
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ten31
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
@@ -0,0 +1,23 @@
+PKG_ID := ten-database
+PKG_VERSION := 0.1.0.1
+REPO_ROOT := $(abspath ../..)
+WRAPPER_DIR := $(CURDIR)
+IMAGE_NAME := start9/$(PKG_ID)/main:$(PKG_VERSION)
+
+.PHONY: image-arm package verify clean
+
+image-arm:
+	docker buildx build --platform=linux/arm64 \
+		-f $(WRAPPER_DIR)/Dockerfile \
+		-t $(IMAGE_NAME) \
+		-o type=docker,dest=$(WRAPPER_DIR)/image.tar \
+		$(REPO_ROOT)
+
+package: image-arm
+	start-sdk pack
+
+verify:
+	start-sdk verify s9pk $(PKG_ID).s9pk
+
+clean:
+	rm -f $(WRAPPER_DIR)/image.tar $(WRAPPER_DIR)/$(PKG_ID).s9pk
@@ -0,0 +1,23 @@
+# Start9 Wrapper (0.3.5)
+
+This directory contains the StartOS 0.3.5 package wrapper for Ten31 Database.
+
+## Build prerequisites
+- Docker with buildx
+- `start-sdk` installed on build machine
+
+## Build package
+```bash
+cd /Users/macpro/Projects/CRM
+make -C start9/0.3.5 package
+```
+
+## Verify package
+```bash
+cd /Users/macpro/Projects/CRM
+make -C start9/0.3.5 verify
+```
+
+## Outputs
+- `start9/0.3.5/image.tar`
+- `start9/0.3.5/ten-database.s9pk`
@@ -0,0 +1,20 @@
+#!/bin/sh
+set -eu
+
+DATA_DIR="${CRM_DATA_DIR:-/data}"
+SECRET_FILE="$DATA_DIR/.crm-secret"
+
+mkdir -p "$DATA_DIR" "$DATA_DIR/backups"
+
+if [ -z "${CRM_SECRET_KEY:-}" ]; then
+  if [ -f "$SECRET_FILE" ]; then
+    CRM_SECRET_KEY="$(cat "$SECRET_FILE")"
+  else
+    CRM_SECRET_KEY="$(head -c 48 /dev/urandom | base64 | tr -d '\n' | tr '/+' 'ab')"
+    printf '%s' "$CRM_SECRET_KEY" > "$SECRET_FILE"
+    chmod 600 "$SECRET_FILE"
+  fi
+  export CRM_SECRET_KEY
+fi
+
+exec python3 /app/backend/server.py
@@ -0,0 +1,5 @@
+#!/bin/sh
+set -eu
+
+PORT="${CRM_PORT:-8080}"
+curl -fsS "http://127.0.0.1:${PORT}/api/health" >/dev/null
@@ -0,0 +1,24 @@
+# Ten31 Database (StartOS 0.3.5)
+
+## What this package does
+- Runs Ten31 Database as a private web app.
+- Persists all data under the StartOS service volume (`/data`).
+- Exposes web UI/API on internal port `8080`.
+
+## First launch
+1. Open the service UI from StartOS.
+2. If this is a fresh install, create the first admin account from the login screen.
+3. Go to Settings and run a manual backup once.
+
+## Airtable migration
+1. Open Settings -> Migration.
+2. Choose "Import from Airtable CSV".
+3. Confirm row/column mappings before final import.
+
+## Data safety
+- Database path in container: `/data/crm.db`.
+- Backups path in container: `/data/backups/`.
+- Before StartOS or package upgrades, run a backup and export from Settings.
+
+## Upgrade note
+This 0.3.5 wrapper keeps app/runtime files separate from data volume so migration to a future 0.4 wrapper can preserve the same data directory layout.
@@ -0,0 +1,95 @@
+id: ten-database
+title: Ten31 Database
+version: 0.1.0.1
+release-notes: >-
+  Initial StartOS 0.3.5 package wrapper for Ten31 Database.
+license: MIT
+wrapper-repo: https://github.com/ten31/ten31-database-startos
+upstream-repo: https://github.com/ten31/ten31-database
+support-site: https://github.com/ten31/ten31-database/issues
+marketing-site: https://ten31.vc
+build: ["make image-arm"]
+min-os-version: 0.3.5
+
+description:
+  short: Self-hosted investor and fundraising database for Ten31.
+  long: >-
+    Ten31 Database is an Airtable-style investor CRM with fundraising grid,
+    communications logging, views, backups, and CSV import. This package stores
+    all runtime data in the service volume for upgrade-safe persistence.
+
+assets:
+  license: LICENSE
+  icon: icon.png
+  instructions: instructions.md
+  docker-images: image.tar
+
+main:
+  type: docker
+  image: main
+  entrypoint: docker_entrypoint.sh
+  args: []
+  mounts:
+    main: /data
+
+health-checks:
+  main:
+    name: API health
+    success-message: CRM API is responding.
+    type: docker
+    image: main
+    entrypoint: healthcheck.sh
+    args: []
+    inject: true
+
+config: ~
+dependencies: {}
+
+volumes:
+  main:
+    type: data
+
+interfaces:
+  main:
+    name: Web Interface
+    description: Browser UI and API for Ten31 Database.
+    tor-config:
+      port-mapping:
+        80: "8080"
+    lan-config:
+      8080:
+        ssl: false
+        internal: 8080
+    ui: true
+    protocols: [http]
+
+backup:
+  create:
+    type: docker
+    image: main
+    system: false
+    entrypoint: sh
+    args:
+      - -c
+      - |
+        set -eu
+        rm -rf /backup/*
+        cp -a /data/. /backup/
+    mounts:
+      main: /data
+      backup: /backup
+  restore:
+    type: docker
+    image: main
+    system: false
+    entrypoint: sh
+    args:
+      - -c
+      - |
+        set -eu
+        cp -a /backup/. /data/
+    mounts:
+      main: /data
+      backup: /backup
+
+actions: {}