standard_procedure_documents 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: decc31ab7e7563240ca1579b908f8cb248c9f27944bb7c6299e14c90b5cbcd38
+  data.tar.gz: 3211e2a568e212200b65f38c184043854f314c095abd448f361436562fde4423
+SHA512:
+  metadata.gz: 48ce632d104a90b03672f1d221936ff1e3c924070da7fd8fc5178e2297fc526af05ed1bf5fff2663cc942196bc7e694dcf72984a7d17baaa19556cc796ef0ebf
+  data.tar.gz: fdc1f364dcd3f00ac0484a75d6c5e376c8885aa9a9679c57c5d3eaebdec30267f04510a462d012a17a61e7b25a6016f4780fbdd193803ba670ae0d498ba1f747

data/README.md

@@ -0,0 +1,109 @@
+# Documents
+Configurable documents
+
+## Usage
+
+### Creating a document from a configuration file 
+
+Build a document using a JSON or YAML file.
+
+This uses [dry-validation](https://dry-rb.org/gems/dry-validation/1.10/) to ensure the schema is valid.
+
+```yaml
+title: Order Form
+elements:
+  - element: paragraph
+    html: <h1>Order Form</h1>
+  - element: paragraph
+    html: <p>Place details of your order below
+  - element: form
+    section_type: static
+    display_type: form
+    fields:
+      - name: company
+        description: Company
+        field_type: "Documents::TextValue"
+        required: true
+      - name: order_date
+        description: Date
+        field_type: "Documents::DateValue"
+        required: true
+        default_value: Date.now 
+  - element: form
+    section_type: repeating
+    display_type: table
+    fields:
+      - name: item
+        description: Item
+        field_type: "Documents::TextValue"
+        required: true
+      - name: quantity
+        description: Quantity
+        field_type: "Documents::IntegerValue"
+        required: true
+        default_value: 1
+  - element: form
+    section_type: static
+    display_type: form
+    fields:
+      - name: ordered_by
+        description: Your name
+        field_type: "Documents::TextValue"
+        required: true
+      - name: signature
+        description: Signed
+        field_type: "Documents::SignatureValue"
+        required: true
+```
+
+Create a "container" - a record within your application that will hold this order form.  Then use the `Document::ElementBuilder` to add it: 
+
+```ruby
+@order_form = OrderForm.create!
+expect(@order_form).to be_kind_of(Documents::Container)
+
+@configuration = YAML.load(File.read("order_form.yml"))
+@order_form.load_elements_from(@configuration)
+
+expect(@order_form.elements.first).to be_kind_of(Documents::Paragraph)
+expect(@order_form.elements.last).to be_kind_of(Documents::Form)
+expect(@order_form.elements.last.fields.last).to be_kind_of(Documents::SignatureValue)
+```
+
+### Document Elements
+
+Documents are built out of an ordered list of Elements.  
+
+Elements can be content, such as Paragraphs, Images, Tables and Forms (although currently only Paragraphs and Forms can be loaded from a configuration file).
+
+### Configuring Forms
+
+Forms are split into two types - static and repeating - and repeating forms can be displayed as a form or a table.  
+
+A static form consists of an ordered list of FieldValues, each with a type, such as `TextValue`, `NumberValue`, `SelectValue` and so on. A repeating form also has an ordered list of FieldValues but the end-user can choose to repeat that group multiple times - for example, in an order form, you may wish to place multiple items on a single form.  
+
+FieldValues can be marked as `required`, `allow_comments` (so the end-user can add arbitrary text to their answer), `allow_attachments` (so the end-user can upload and attach files, photos and other documents to support their answer).  They can also specify a `default_value` (the meaning of which varies according to the field type) and select and multi-select values also have `options` - key/value pairs that they can pick in the user-interface.  
+
+Finally, FieldValues can also be marked as `allow_tasks` - which means that a follow-up task system can be used alongside the form itself (for example, if performing a safety inspection, noting something that is not compliant and therefore assigning a fix to another person).  
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem "standard_procedure_documents"
+```
+
+And then execute:
+```bash
+$ bundle
+```
+Then copy the migrations to your Rails application:
+```bash
+bin/rails standard_procedure_documents:migrations:install db:migrate db:test:prepare
+```
+
+## Contributing
+Contributions welcome
+
+## License
+The gem is available as open source under the terms of the [LGPL License](/LICENCE).

data/Rakefile

@@ -0,0 +1,16 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("spec/test_app/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+load "rails/tasks/statistics.rake"
+
+require "bundler/gem_tasks"
+
+require "rspec/core"
+require "rspec/core/rake_task"
+
+desc "Run all specs in spec directory (excluding plugin specs)"
+RSpec::Core::RakeTask.new(spec: "app:db:test:prepare")
+
+task default: :spec

data/app/models/concerns/documents/container.rb

@@ -0,0 +1,44 @@
+module Documents::Container
+  extend ActiveSupport::Concern
+
+  included do
+    has_many :elements, -> { order :position }, class_name: "Documents::Element", as: :container, dependent: :destroy
+  end
+
+  def load_elements_from configuration
+    result = Documents::DocumentDefinition.new.call(configuration)
+    raise ArgumentError.new(result.errors.to_h.to_json) if result.errors.any?
+
+    configuration["elements"].each do |element_config|
+      case element_config["element"]
+      when "paragraph"
+        elements.create!(
+          type: "Documents::Paragraph",
+          position: :last,
+          html: element_config["html"],
+          description: element_config["description"] || ""
+        )
+      when "form"
+        form = elements.create!(
+          type: "Documents::Form",
+          position: :last,
+          section_type: element_config["section_type"],
+          display_type: element_config["display_type"],
+          description: element_config["description"] || ""
+        )
+
+        # Create field values for the first section
+        section = form.sections.first
+        element_config["fields"]&.each do |field_config|
+          section.field_values.create!(
+            type: field_config["field_type"],
+            name: field_config["name"],
+            description: field_config["description"],
+            required: field_config["required"] || false,
+            position: :last
+          )
+        end
+      end
+    end
+  end
+end

data/app/models/documents/checkbox_value.rb

@@ -0,0 +1,15 @@
+module Documents
+  class CheckboxValue < FieldValue
+    has_attribute :value, :boolean
+    before_validation :set_default_value, if: -> { value.nil? && default_value.present? }
+    validates :value, inclusion: {in: [true, false], message: :invalid_boolean}, on: :update, if: -> { required? }
+
+    def to_s = value ? "☑️" : "⊗"
+
+    private def set_default_value
+      self.value = DEFAULTS[default_value.to_s].nil? ? ActiveModel::Type::Boolean.new.cast(default_value) : DEFAULTS[default_value.to_s]
+    end
+
+    DEFAULTS = {"yes" => true, "y" => true, "no" => false, "n" => false}.freeze
+  end
+end

data/app/models/documents/data_value.rb

@@ -0,0 +1,12 @@
+module Documents
+  class DataValue < FieldValue
+    has_model :value
+    has_attribute :data_class, :string, default: ""
+    validates :value, presence: true, on: :update, if: -> { required? }
+    validate :value_is_correct_class, if: -> { data_class.present? }
+
+    private def value_is_correct_class
+      errors.add :value, :invalid_data_class if value.present? && !value.is_a?(data_class.constantize)
+    end
+  end
+end

data/app/models/documents/date_value.rb

@@ -0,0 +1,13 @@
+module Documents
+  class DateValue < FieldValue
+    has_attribute :value, :date
+    before_validation :set_default_value, if: -> { value.blank? && default_value.present? }
+    validates :value, presence: true, on: :update, if: -> { required? }
+
+    def to_s = value.present? ? I18n.l(value, format: :long) : ""
+
+    private def set_default_value
+      self.value = (default_value == "today") ? Date.current : Date.parse(default_value)
+    end
+  end
+end

data/app/models/documents/decimal_value.rb

@@ -0,0 +1,14 @@
+module Documents
+  class DecimalValue < FieldValue
+    has_attribute :value, :decimal
+    before_validation :set_default_value, if: -> { value.blank? && default_value.present? }
+    validates :value, presence: true, on: :update, if: -> { required? }
+    validates :value, numericality: true, allow_blank: true
+
+    def to_s = value.present? ? value.to_f.round(2) : ""
+
+    private def set_default_value
+      self.value = default_value.to_f
+    end
+  end
+end

data/app/models/documents/download.rb

@@ -0,0 +1,9 @@
+module Documents
+  class Download < Element
+    validate :file_is_attached
+
+    private def file_is_attached
+      errors.add :file, :blank unless file.attached?
+    end
+  end
+end

data/app/models/documents/element.rb

@@ -0,0 +1,19 @@
+module Documents
+  class Element < ApplicationRecord
+    include HasAttributes
+    serialize :data, type: Hash, coder: JSON
+    belongs_to :container, polymorphic: true
+    validate :container_is_legal
+    positioned on: :container
+    attribute :description, :string, default: ""
+    has_one_attached :file
+
+    def copy_to(target_container, copy_as_template: false) = nil
+
+    def path = position.to_s
+
+    private def container_is_legal
+      errors.add :container, :invalid unless container.is_a? Documents::Container
+    end
+  end
+end

data/app/models/documents/email_value.rb

@@ -0,0 +1,5 @@
+module Documents
+  class EmailValue < TextValue
+    validates :value, format: {with: URI::MailTo::EMAIL_REGEXP, message: :invalid_email}, on: :update, allow_blank: true
+  end
+end

data/app/models/documents/field_value.rb

@@ -0,0 +1,17 @@
+module Documents
+  class FieldValue < ApplicationRecord
+    include HasAttributes
+    serialize :data, type: Hash, coder: JSON
+    belongs_to :section, class_name: "FormSection"
+    positioned on: :section
+    has_attribute :default_value, :string
+    has_many_attached :files
+    has_many_attached :attachments
+    has_attribute :comments, :string, default: ""
+    def has_value? = value.present?
+
+    def path = [section.path, name.to_s].join("/")
+
+    def to_s = value.to_s
+  end
+end

data/app/models/documents/file_value.rb

@@ -0,0 +1,14 @@
+module Documents
+  class FileValue < FieldValue
+    def value = files
+    validate :files_are_attached, on: :update, if: -> { required? }
+
+    def has_value? = files.attached?
+
+    def to_s = files.map(&:filename).map(&:to_s).join(", ")
+
+    private def files_are_attached
+      errors.add :files, :blank unless files.attached?
+    end
+  end
+end

data/app/models/documents/form.rb

@@ -0,0 +1,12 @@
+module Documents
+  class Form < Element
+    enum :section_type, {static: 0, repeating: 1}, prefix: true
+    enum :display_type, {form: 0, table: 1}, prefix: true
+    enum :form_submission_status, draft: 0, submitted: 1, cancelled: -1
+
+    has_many :sections, -> { order :position }, class_name: "FormSection", dependent: :destroy
+    after_save :create_first_section, if: -> { sections.empty? }
+
+    private def create_first_section = sections.create!
+  end
+end

data/app/models/documents/form_section.rb

@@ -0,0 +1,9 @@
+module Documents
+  class FormSection < ApplicationRecord
+    belongs_to :form, inverse_of: :sections
+    positioned on: :form
+    has_many :field_values, -> { order :position }, inverse_of: :section, dependent: :destroy
+
+    def path = [form.path, position.to_s].join("/")
+  end
+end

data/app/models/documents/image.rb

@@ -0,0 +1,14 @@
+module Documents
+  class Image < Element
+    validate :file_is_attached
+    validate :file_is_image
+
+    private def file_is_attached
+      errors.add :file, :blank unless file.attached?
+    end
+
+    private def file_is_image
+      errors.add :file, :invalid unless file.image?
+    end
+  end
+end

data/app/models/documents/image_value.rb

@@ -0,0 +1,9 @@
+module Documents
+  class ImageValue < FileValue
+    validate :files_are_images, if: -> { files.attached? }
+
+    private def files_are_images
+      errors.add :files, :invalid unless files.all?(&:image?)
+    end
+  end
+end

data/app/models/documents/location_value.rb

@@ -0,0 +1,12 @@
+module Documents
+  class LocationValue < FieldValue
+    has_attribute :latitude, :float
+    validates :latitude, presence: true, on: :update, if: -> { required? }
+    has_attribute :longitude, :float
+    validates :longitude, presence: true, on: :update, if: -> { required? }
+
+    def value = {longitude: longitude, latitude: latitude}
+
+    def to_s = value.to_json
+  end
+end

data/app/models/documents/multi_select_value.rb

@@ -0,0 +1,32 @@
+module Documents
+  class MultiSelectValue < FieldValue
+    has_attribute :value, :json, default: []
+    has_attribute :options, :json, default: {}
+    before_validation :set_default_value, if: -> { value.blank? && default_value.present? }
+    validates :value, presence: {message: :required}, on: :update, if: -> { required? }
+    validate :all_values_are_valid_options, if: -> { value.present? && options.any? }
+    validate :default_value_contains_valid_options, if: -> { default_value.present? && options.any? }
+
+    def to_s = Array.wrap(value).map { |key| options[key] || key }.join(", ")
+
+    private def set_default_value
+      self.value = Array.wrap(parse_default_value)
+    end
+
+    private def all_values_are_valid_options
+      errors.add :value, :invalid_option if invalid_keys_in?(value)
+    end
+
+    private def default_value_contains_valid_options
+      errors.add :default_value, :invalid_default_option if invalid_keys_in?(parse_default_value)
+    end
+
+    private def invalid_keys_in?(keys) = (Array.wrap(keys) - options.keys).any?
+
+    private def parse_default_value
+      JSON.parse(default_value.to_s)
+    rescue JSON::ParserError
+      [default_value]
+    end
+  end
+end

data/app/models/documents/number_value.rb

@@ -0,0 +1,12 @@
+module Documents
+  class NumberValue < FieldValue
+    has_attribute :value, :integer
+    before_validation :set_default_value, if: -> { value.blank? && default_value.present? }
+    validates :value, presence: true, on: :update, if: -> { required? }
+    validates :value, numericality: {only_integer: true}, allow_blank: true
+
+    private def set_default_value
+      self.value = default_value.to_i
+    end
+  end
+end

data/app/models/documents/page_break.rb

@@ -0,0 +1,4 @@
+module Documents
+  class PageBreak < Element
+  end
+end

data/app/models/documents/paragraph.rb

@@ -0,0 +1,6 @@
+module Documents
+  class Paragraph < Element
+    attribute :html, :string, default: ""
+    validates :html, presence: true
+  end
+end

data/app/models/documents/phone_value.rb

@@ -0,0 +1,5 @@
+module Documents
+  class PhoneValue < TextValue
+    validates :value, format: {with: /\A[\+\-\(\)\s\d\.]+\z/, message: :invalid_phone}, on: :update, allow_blank: true
+  end
+end

data/app/models/documents/rich_text_value.rb

@@ -0,0 +1,5 @@
+module Documents
+  class RichTextValue < TextValue
+    # Identical to TextValue - supports rich HTML content
+  end
+end

data/app/models/documents/select_value.rb

@@ -0,0 +1,20 @@
+module Documents
+  class SelectValue < FieldValue
+    has_attribute :value, :string
+    has_attribute :options, :json, default: {}
+    before_validation :set_default_value, if: -> { value.blank? && default_value.present? }
+    validates :value, presence: {message: :required}, on: :update, if: -> { required? }
+    validates :value, inclusion: {in: ->(record) { record.options.keys }, message: :invalid_option}, on: :update, allow_blank: true
+    validate :default_value_is_valid_option, if: -> { default_value.present? && options.any? }
+
+    def to_s = value.present? ? (options[value] || value) : ""
+
+    private def set_default_value
+      self.value = default_value
+    end
+
+    private def default_value_is_valid_option
+      errors.add :default_value, :invalid_default_option unless options.key?(default_value)
+    end
+  end
+end

data/app/models/documents/signature_value.rb

@@ -0,0 +1,7 @@
+module Documents
+  class SignatureValue < FieldValue
+    has_attribute :value, :text
+    validates :value, presence: {message: :required_signature}, on: :update, if: -> { required? }
+    validates :value, format: {with: /\Adata:image\/(png|svg\+xml);base64,[A-Za-z0-9+\/]+=*\z/, message: :invalid_signature}, on: :update, allow_blank: true
+  end
+end

data/app/models/documents/table.rb

@@ -0,0 +1,6 @@
+module Documents
+  class Table < Element
+    include Container
+    attribute :column, :integer, default: 0
+  end
+end

data/app/models/documents/text_value.rb

@@ -0,0 +1,11 @@
+module Documents
+  class TextValue < FieldValue
+    has_attribute :value, :string
+    before_validation :set_default_value, if: -> { value.blank? && default_value.present? }
+    validates :value, presence: true, on: :update, if: -> { required? }
+
+    private def set_default_value
+      self.value = default_value
+    end
+  end
+end

data/app/models/documents/time_value.rb

@@ -0,0 +1,13 @@
+module Documents
+  class TimeValue < FieldValue
+    has_attribute :value, :datetime
+    before_validation :set_default_value, if: -> { value.blank? && default_value.present? }
+    validates :value, presence: true, on: :update, if: -> { required? }
+
+    def to_s = value.present? ? I18n.l(value, format: :short) : ""
+
+    private def set_default_value
+      self.value = (default_value == "now") ? Time.current : Time.parse(default_value)
+    end
+  end
+end

data/app/models/documents/url_value.rb

@@ -0,0 +1,5 @@
+module Documents
+  class UrlValue < TextValue
+    validates :value, format: {with: URI::DEFAULT_PARSER.make_regexp(%w[http https]), message: :invalid_url}, on: :update, allow_blank: true
+  end
+end

data/app/models/documents/video.rb

@@ -0,0 +1,6 @@
+module Documents
+  class Video < Element
+    attribute :url, :string, default: ""
+    validates :url, presence: true, format: /\A#{URI::RFC2396_REGEXP::PATTERN::ABS_URI}\Z/o
+  end
+end

data/config/locales/en.yml

@@ -0,0 +1,43 @@
+en:
+  activerecord:
+    errors:
+      models:
+        documents/checkbox_value:
+          attributes:
+            value:
+              invalid_boolean: must be true or false
+        documents/data_value:
+          attributes:
+            value:
+              invalid_data_class: Invalid data class
+        documents/email_value:
+          attributes:
+            value:
+              invalid_email: must be a valid email address
+        documents/multi_select_value:
+          attributes:
+            default_value:
+              invalid_default_option: Invalid default option
+            value:
+              invalid_option: Invalid option
+              required: Required
+        documents/phone_value:
+          attributes:
+            value:
+              invalid_phone: must be a valid phone number
+        documents/select_value:
+          attributes:
+            default_value:
+              invalid_default_option: Invalid default option
+            value:
+              invalid_option: Invalid option
+              required: Required
+        documents/signature_value:
+          attributes:
+            value:
+              invalid_signature: Invalid signature
+              required_signature: Required signature
+        documents/url_value:
+          attributes:
+            value:
+              invalid_url: must be a valid URL

data/config/routes.rb

@@ -0,0 +1,2 @@
+Rails.application.routes.draw do
+end

data/db/migrate/20250721133645_create_documents_elements.rb

@@ -0,0 +1,19 @@
+class CreateDocumentsElements < ActiveRecord::Migration[8.0]
+  def change
+    create_table :documents_elements do |t|
+      t.string :type
+      t.belongs_to :container, polymorphic: true, index: true
+      t.integer :position, null: false
+      t.text :description
+      t.text :html
+      t.string :url
+      t.integer :columns, default: 0, null: false
+      t.integer :section_type, default: 0, null: false
+      t.integer :display_type, default: 0, null: false
+      t.integer :form_submission_status, default: 0, null: false
+      t.text :data
+      t.timestamps
+      t.index [:container_type, :container_id, :position], unique: true
+    end
+  end
+end

data/db/migrate/20250721135716_create_documents_form_sections.rb

@@ -0,0 +1,10 @@
+class CreateDocumentsFormSections < ActiveRecord::Migration[8.0]
+  def change
+    create_table :documents_form_sections do |t|
+      t.belongs_to :form, foreign_key: {to_table: "documents_elements"}
+      t.integer :position, null: false
+      t.timestamps
+      t.index [:form_id, :position], unique: true
+    end
+  end
+end

data/db/migrate/20250721135938_create_documents_field_values.rb

@@ -0,0 +1,18 @@
+class CreateDocumentsFieldValues < ActiveRecord::Migration[8.0]
+  def change
+    create_table :documents_field_values do |t|
+      t.belongs_to :section, foreign_key: {to_table: "documents_form_sections"}
+      t.integer :position, null: false
+      t.text :data
+      t.string :name, null: false
+      t.string :description, null: false
+      t.string :type
+      t.boolean :required, default: false, null: false
+      t.boolean :allow_comments, default: false, null: false
+      t.boolean :allow_attachments, default: false, null: false
+      t.boolean :allow_tasks, default: false, null: false
+      t.timestamps
+      t.index [:section_id, :position], unique: true
+    end
+  end
+end

data/lib/documents/document_definition.rb

@@ -0,0 +1,16 @@
+module Documents
+  # Describes a document template, built out of multiple "elements".
+  # Each element can be a paragraph or other piece of content,
+  # or it could be the definition of a "form",
+  # describing the questions the eventual document will contain
+  # that must be answered by the end-user
+
+  DocumentDefinitionSchema = Dry::Schema.Params do
+    required(:title).filled(:string)
+    required(:elements).array(Documents::ElementDefinitionSchema)
+  end
+
+  class DocumentDefinition < Dry::Validation::Contract
+    params(DocumentDefinitionSchema)
+  end
+end

data/lib/documents/element_definition.rb

@@ -0,0 +1,27 @@
+module Documents
+  ElementDefinitionSchema = Dry::Schema.Params do
+    required(:element).filled(:string, included_in?: %w[paragraph form])
+    optional(:description).maybe(:string)
+    optional(:html).filled(:string)
+    optional(:section_type).filled(:string, included_in?: %w[static repeating])
+    optional(:display_type).filled(:string, included_in?: %w[form table])
+    optional(:fields).array(Documents::FieldDefinitionSchema)
+  end
+
+  class ElementDefinition < Dry::Validation::Contract
+    params(ElementDefinitionSchema)
+
+    rule :html do
+      key.failure(:blank) if (values[:element] == "paragraph") && values[:html].blank?
+    end
+    rule :section_type do
+      key.failure(:blank) if (values[:element] == "form") && values[:section_type].blank?
+    end
+    rule :display_type do
+      key.failure(:blank) if (values[:element] == "form") && values[:display_type].blank?
+    end
+    rule :fields do
+      key.failure(:blank) if (values[:element] == "form") && values[:fields].empty?
+    end
+  end
+end

data/lib/documents/engine.rb

@@ -0,0 +1,11 @@
+module Documents
+  class Engine < ::Rails::Engine
+    isolate_namespace Documents
+
+    config.generators do |g|
+      g.test_framework :rspec
+      g.assets false
+      g.helper false
+    end
+  end
+end

data/lib/documents/field_definition.rb

@@ -0,0 +1,22 @@
+module Documents
+  FieldDefinitionSchema = Dry::Schema.Params do
+    required(:name).filled(:string)
+    required(:description).filled(:string)
+    required(:field_type).filled(included_in?: %w[Documents::CheckboxValue Documents::DateValue Documents::DateTimeValue Documents::DecimalValue Documents::EmailValue Documents::FileValue Documents::LocationValue Documents::ImageValue Documents::DataValue Documents::MultiSelectValue Documents::NumberValue Documents::PhoneValue Documents::RichTextValue Documents::SelectValue Documents::TextValue Documents::TimeValue Documents::UrlValue Documents::SignatureValue])
+    required(:required).filled(:bool)
+    optional(:allow_comments).filled(:bool)
+    optional(:allow_attachments).filled(:bool)
+    optional(:allow_tasks).filled(:bool)
+    optional(:default_value).maybe(:string)
+    optional(:options).filled(:hash)
+    optional(:data_class).filled(:string)
+  end
+
+  class FieldDefinition < Dry::Validation::Contract
+    params(FieldDefinitionSchema)
+
+    rule(:options) do
+      key.failure(:blank) if %w[Documents::SelectValue Documents::MultiSelectValue].include?(values[:field_type]) && values[:options].empty?
+    end
+  end
+end

data/lib/documents/version.rb

@@ -0,0 +1,3 @@
+module Documents
+  VERSION = "0.1.0"
+end

data/lib/documents.rb

@@ -0,0 +1,11 @@
+require "dry/validation"
+require "positioning"
+require "has_attributes"
+require "documents/version"
+require "documents/engine"
+
+module Documents
+  require_relative "documents/field_definition"
+  require_relative "documents/element_definition"
+  require_relative "documents/document_definition"
+end

data/lib/standard_procedure_documents.rb

@@ -0,0 +1 @@
+require_relative "documents"

data/lib/tasks/documents_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :documents do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: standard_procedure_documents
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Rahoul Baruah
+bindir: bin
+cert_chain: []
+date: 2025-07-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.1.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.1.3
+- !ruby/object:Gem::Dependency
+  name: dry-validation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: standard_procedure_has_attributes
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: positioning
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Documents
+email:
+- rahoulb@echodek.co
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- app/models/concerns/documents/container.rb
+- app/models/documents/checkbox_value.rb
+- app/models/documents/data_value.rb
+- app/models/documents/date_value.rb
+- app/models/documents/decimal_value.rb
+- app/models/documents/download.rb
+- app/models/documents/element.rb
+- app/models/documents/email_value.rb
+- app/models/documents/field_value.rb
+- app/models/documents/file_value.rb
+- app/models/documents/form.rb
+- app/models/documents/form_section.rb
+- app/models/documents/image.rb
+- app/models/documents/image_value.rb
+- app/models/documents/location_value.rb
+- app/models/documents/multi_select_value.rb
+- app/models/documents/number_value.rb
+- app/models/documents/page_break.rb
+- app/models/documents/paragraph.rb
+- app/models/documents/phone_value.rb
+- app/models/documents/rich_text_value.rb
+- app/models/documents/select_value.rb
+- app/models/documents/signature_value.rb
+- app/models/documents/table.rb
+- app/models/documents/text_value.rb
+- app/models/documents/time_value.rb
+- app/models/documents/url_value.rb
+- app/models/documents/video.rb
+- config/locales/en.yml
+- config/routes.rb
+- db/migrate/20250721133645_create_documents_elements.rb
+- db/migrate/20250721135716_create_documents_form_sections.rb
+- db/migrate/20250721135938_create_documents_field_values.rb
+- lib/documents.rb
+- lib/documents/document_definition.rb
+- lib/documents/element_definition.rb
+- lib/documents/engine.rb
+- lib/documents/field_definition.rb
+- lib/documents/version.rb
+- lib/standard_procedure_documents.rb
+- lib/tasks/documents_tasks.rake
+homepage: https://theartandscienceofruby.com/
+licenses:
+- LGPL
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://theartandscienceofruby.com/
+  source_code_uri: https://github.com/standard_procedure
+  changelog_uri: https://github.com/standard_procedure
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: 'Standard Procedure: Documents'
+test_files: []